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NOTICE 


Apple Computer, Inc. reserves the right to make improvements in the 
product described in this manual at any time and without notice. 
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OR LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE 
LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU. 


This manual is copyrighted and contains proprietary information. All 
rights are reserved. This document may not, in whole or in part, be 
copied, photocopied, reproduced, translated, or reduced to any 
electronic medium or machine-readable form without prior consent, in 
writing, from Apple Computer, Inc. 
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PLEASE READ THIS MANUAL BEFORE ATTEMPTING TO INSTALL THE APPLE II 
IEEE-488 INTERFACE CARD IN THE APPLE COMPUTER. INCORRECT 
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CHAPTER 1 
GETTING STARTED 


The Apple II IEEE-488 Interface Card provides a standard, 
plug-compatible, input/output bus for microcomputers. It allows your 
Apple II to control or communicate with up to 14 external devices. 
The external devices may be measuring instruments, data logging 
devices, or one or more of many available peripheral devices. These 
devices must all have bus interfaces which comply with the technical, 
electrical and mechanical requirements of IEEE Standard 488. 
Approximately 69@ devices are currently available which use some form 
of this proposed standard input/output bus. 


WHAT IS THE APPLE II GPIB? 


The formal name for this type of bus is "IEEE Standard Digital 
Interface for Programmable Instrumentation, 1978". The complete 
document, IEEE Standard 488-1978, may be obtained from the Institute 
of Electrical and Electronic Engineers, Inc. The instrument bus is 
also known as the "IEEE-488 Interface Bus", the "General Purpose 
Interface Bus" (GPIB) or the "Hewlett-Packard Interface Bus" (HP-IB®). 
You will not need to use the IEEE Standard 488 documentation unless 
you need actual design information for the construction of an 
interface device. 


The Apple II IEEE-488 Interface will be referred to as the Apple II 
GPIB, or just the GPIB, throughout the rest of this manual. The 
Apple II GPIB consists of the interface circuit card and the 
interface cable. When we discuss the GPIB, remember that the terms 
"Apple II IEEE-488 Interface Card", "IEEE-488 bus" and "HP-IB®" all 
refer to the same type of universal I/O bus interface and bus 
Operation. The interface circuit card itself will be referred to as 
the Apple II GPIB interface card, or just as the IEEE-488 card. 


The Apple II GPIB interface card is the heart of the input/output 
Operation. The interface card plugs into an Apple II connector slot 
and controls all transfers over the bus. The interface card is 
Slot-independent; in other words, the interface card may be installed 
in any connector slot in the Apple (except slot 9). The interface 
card provides remote device control through simple BASIC commands 
From your program. 


The interface card circuits perform the function of translating 
Integer BASIC or Applesoft BASIC instructions into commands 
understood by devices. The interface circuits include a controller 


which does all of the timing, control, and formatting for the 


instrument bus. The interface card also contains a read-only memory 
(ROM) that provides the control information needed by the interface 


controller circuit to interpret BASIC commands. 
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WORDS OF ADVICE 


Although the electrical characteristics of the bus are clearly 
specified by IEEE Standard 488, the addressing conventions, input 
data format, and output data format can vary from one device to the 
next. You must carefully study the manufacturer’s operating manual 
for each device before attempting to place the device in service on 
the bus. For example, the output data may be ASCII or binary. If it 


is binary, the least significant bit of each byte may be transmitted 
first or last, and so on. 


There are no really good reference books available for setting up and 
operating a system under the IEEE-488 proposed standard. You must 
have a thorough command of BASIC or APPLESOFT programming and a 
working knowledge of DOS. If you do not, then refer to the BASIC and 
DOS manuals and practice the examples. You may also need to 


understand the relationship between ASCII, hexadecimal, octal, and 
binary notation. Conversion tables are included in an appendix. 


A test device which can be plugged into the bus and which can be used 
to test the commands and data sent by your program may be 
advantageous. A device that can single-step the bus program is 


almost a necessity for complex systems. One such test device now 
available is the model ZT488 GPIB ANALYZER manufactured by Ziatech 


Corporatione Operation of the bus may also be tested by use of a 


Tektronix or Hewlett-Packard logic analyzer. Another useful device 
is the Gould Model K19¢QD/4@8 GPIB Analyzer. 


SPECIAL SYMBOLS 


This manual uses some special symbols to indicate particularly 
noteworthy pieces of information. If you see the symbol 


it means that the following paragraph discusses some possibly 


unexpected Apple behavior. The symbol 


means that the following paragraph contains special 


information that may be useful to you. Read these sections 
carefully. 
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WHAT YOU WILL NEED 


The Apple II IEEE-488 Interface Card is designed for experienced 
users who are familiar with APPLESOFT or Integer BASIC, and DOS 3.2 
or DOS 3.3. Those who wish to use the card with the Apple Pascal 
Operating System should be familiar with Apple Pascal, its operating 
system, and 6592 assembly language. 


The programs described in this manual, as well as the firmware used 
by the card, will run on an Apple II or an Apple II Plus with at 
least 32K memory, and at least one Disk II drive and controller. 


Six items make up your Apple II IEEE-488 Interface Card package: 


1. Apple II IEEE-488 Interface Card 
Part # 939-9670-G0G16 

2. Interconnection cable with metal clamp on it 
Part # 939-959¢6-093¢ 

3. Two IEEE standard screws 

4. Two non-standard screws 

5. A warranty card 

6. This manual 


Carefully unpack all the items in your shipment. Fill out the 
warranty card and mail it to your Apple dealer. 


INSTALLING THE INTERFACE CARD 


Read this section carefully, even if you have installed Apple 
peripheral interface cards before. The Apple II GPIB interface card 
is easy to install, but it is important to install it correctly. 


Before connecting or disconnecting anything on the Apple, turn 


off the power with the switch on the back left corner of the 
Apple case. THIS IS NECESSARY. If you try to connect or 
disconnect anything from the inside of your Apple when the 
power is on, you are likely to damage the circuits and lose 
anything currently stored in random access memory (RAM). 


Do not unplug the Apple; just turn it off. If you unplug the Apple, 
you will isolate it from earth ground and leave it vulnerable to 
static discharges. 


Remove the Apple cover by pulling up on the two back corners of the 
cover until the two corner fasteners pop apart. Slide the cover back 
until it is free of the case and lift the cover off. 


Look inside the Apple and locate the power supply case. The power 
supply is the rectangular metal box in the left rear corner. Touch 
the power supply case with one hand to discharge any static charge 
that may be on your clothes or body. 
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Along the back inside edge of the Apple you will see eight long 
narrow slots called "connector slots". The connector slots are 
numbered from @ at the left corner to 7 at the right corner. The 
numbers are printed along the back edge behind the connector slots. 
The connector slots are shown in the following photograph. 


for Slot 3) 


ee 

ee 
gee 

ee 


ca | 


Your disk controller card is plugged into slot 6. If you have more 
than two drives, a second disk controller card is plugged into 

slot 4 or 5. If you have an Apple Language Card, it is plugged into 
slot Q@. If you have a printer, the printer interface card is 
probably plugged into slot 1. This manual assumes that you will plug 
the Apple II GPIB interface card into slot 3. If you are going to 


plug your card into another slot, substitute that slot’s number for 
all references to slot 3 in this manual. 


The Apple IEEE interconnection cable is shown below. 


Card 


Cable 
Metal Connector Clamp \ Connector 


Back ‘Sioe 
Larger 


Non-Standard 
Screw ww 


"4 


Smaller 
Non-Standard 
Screw 


IEEE Standard Nota Ground Wire 


Cable Somectoty 


eo 


Standard IEEE Screws 


<r Connector Clamp 
Front Half 


Protective Layer 
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The IEEE standard cable connector is at the left. This connector is 
the one to which other devices will be attached. Just to the right 
of the IEEE connector is a two piece metal clamp. We will refer to 
the part of the clamp nearest the IEEE connector as the back half of 
the clamp. The other half of the connector clamp, the front half, 
has an narrow cable pathway with the cable going through it. At the 
right end of the cable is the interface card’s connector. 


When the two halves of the clamp are nestled snugly together, as they 
are in the photograph above, they form a rectangular enclosure with 
an opening for the IEEE connector on the left, an opening for the 
cable on the right, and two other large openings. These two openings 
allow the clamp to slide into one of the slots in the back of the 
case itself. Be sure that the two halves are together, but not too 
tightly; the case must fit into the openings. 


The left end of the cable, by the IEEE connector, is covered by a 
protective layer, beneath which one of the wires, the shield ground, 
is severed. A new wire, attached to the IEEE connector end of the 
severed wire, extends from beneath the protective covering. Make 


sure that this wire runs parallel to the IEEE cable, and through the 
cable pathway in the front half of the metal connector clamp. This 


wire will be attached to case ground. 


The card connector on the bus cable plugs into a connector on the 
end of the interface card. Hold the bus cable so that the tab on 
the cable’s card connector is aligned with the slot on the card’s 
connector. Press the cable’s connector into the card’s connector 
until it is firmly seated, as shown in the next photograph. 


Cable Connector 
Card Connector 
Tab in Slot 


(> Handle the interface card as you would handle an expensive 


phonograph record. Grasp it only by the corners or edges, and 
do not touch the components or pins, especially the edge 
connector fingers. 
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Grasp the upper edge of the interface card in your right hand, and 
the metal connector clamp for the IEEE connector in your left. Slide 
the metal connector clamp into an available slot in the back of the 
Apple’s case; if the clamp does not slide easily, pull the front and 
back halves a little farther apart, making the opening for the case 
larger. Simultaneously guide the card towards connector slot 3 with 
your right hand. 


Insert the gold “fingers" of the interface card edge connector into 
slot 3, rear edge first. Gently push the front edge of the card down 
until it is level and firmly seated as shown in the photograph. 


Using the smaller of the two non-standard screws, attach the shield 
ground wire, which should be right alongside the bus cable, to the 
hole in the lower part of the front half of the connector clamp. By 
doing so, you connect the shield ground line for the bus to the case 
ground of the Apple II. The line should be connected as shown in the 


photo above. 


<(e> If your Apple II does not have a metallic interior, your 
shield ground will not be connected to ground. 


For the final step of the installation process, turn the Apple around 
so the rear of the case points towards you.e Make sure that the metal 
connector clamp rests securely in the case slot, positioned as far 
down as possible. Take one of the two standard IEEE screws, place it 
through one of the two holes in the IEEE connector so that it goes 
into the corresponding hole in the metal connector clamp, and tighten 
it. Repeat this procedure with the other IEEE screw and other 
connector hole. 
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You have just accomplished two things. You have tightened the metal 
connector clamp against the back of the case, preventing the 
connector from moving in the slot, and improving the connection 
between the clamp and case ground. You have also fastened the IEEE 
connector firmly in place so that there is no chance of putting undue 
strain on the cable. The connection, as seen from the rear of the 
Apple, appears in the next photograph. 


The remaining screw may be used to suppress the radio frequency 
interference signals which radiate from the bus cable. If used, the 
screw should join the shield of the cable connected to the IEEE 
connector in the back of the Apple to the top hole in the front half 
of the metal connector clamp. 


Slide the Apple case top plate in place and press down on the rear 


corners until the corner fasteners pop into place. The Apple II 
IEEE~488 Interface Bus is now installed and ready to use. 
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CHAPTER 2 
THE IEEE-488 INTERFACE CARD 


The Apple II IERE-488 Interface Card is one of several "standardized" 
input/output (1/0) interfaces which have been developed since 1972 in 
the effort to provide a universal I/0 bus. 


The advantage of the Apple II GPIB is that it conforms to LEEE 
Standard 488 and that a single interface card lets your Apple II 
control and communicate with up to 14 other data gathering or 
processing units. It uses a commercially available standard 
interface cable with piggyback connectors which allow the devices on 
the bus to be daisy chained or star connected as shown in Figures 
2-2 and 2-3. The standard cable connects to all devices designed to 
Operate under the IEEE-488 proposed standard. 


CONTROLLERS, TALKERS AND LISTENERS 


The Apple II GPIB uses eight data lines and eight control lines to 
transfer commands and data to and from the I/O devices on the bus. A 
block diagram of the bus is shown in Figure 2-1. The devices on the 
bus can be described in terms of their primary functions of 
controller, talker, and listener. 


Any device on the bus is designated a "talker" when its primary 
function is the transmission of data. An example of a talker is a 
digital voltmeter. If a talker transmits data over the bus 
continuously, no other devices can use the bus; therefore, the talker 
function is turned on by the controller when necessary. 


Any device on the bus is designated a "listener" when its primary 
function is the execution of commands. A printer is such a device. 
If a listener accepted all commands and data transmitted on the bus, 
chaos would result; therefore, the listener function must also be 
turned on by the controller. Some listeners also have a talker 
function. 


The "controller" is the device that arbitrates all transfers of data 
on the bus. The controller is the device that can turn on a talker 
for the transmission of data. Likewise, the controller is the device 
that can turn on a listener for the reception of data. 


Only one controller is allowed on this implementation of the 
bus. This controller must be your Apple. 


A controller is able to interact with both talkers and listeners in 


various ways. The exact capabilities of the Apple as controller are 
detailed in the chapter on programming the GPIB. 


IEEE-488 INTERFACE CARD 9 


APPLE COMPUTER | REMOTE DEVICE 


Able to Control, | Able to Talk 
Talk, & Listen Only 


(example: Frequency 
Counter) 


REMOTE DEVICE 


Able to Listen 
Only 


REMOTE DEVICE (example: Printer) 


Able to Talk 


and Listen 
DATA LINES 


(example: Digital D101-D108 Data Input/Output 
Multimeter) =) 
TRANSFER CONTROL LINES 

DAV (Data Valid) 

NRFD (Not Ready For Data) 

NDAC (Not Data Accepted) 
MANAGEMENT CONTROL LINES 

IFC (Interface Clear) 

ATN (Attention) : 

SRQ (Service Request) 

REN (Remote Enable) 

EOI (End-Or-Identify) 
Up to 1l additional Remote Devices 
may be placed on the bus. 


Figure 2-1. Apple II GPIB Functional Block Diagram. 


PHYSICAL REQUIREMENTS 


We have already stated that the Apple II GPIB can control up to 14 
external devices. There are some limits on the total length of the 
bus and the distance between devices. The standard states that the 
total length of the bus may not exceed two meters times the number of 


devices on the bus. The maximum length of the entire bus is 29 
meters. 


The devices on the bus can be connected in either a daisy chain or a 
star configuration using the stackable connectors of the available 
standard bus cables. Daisy chain connections are preferred by most 
system designers, since the star connector stack may be unwieldy in 
larger systems. A sketch of star and daisy chain connected equipment 
are shown in Figures 2-2 and 2-3. 
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Figure 2-2. Daisy Chain Configuration. 
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Figure 2-3. Star Connected Configuration. 
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Stackable or piggyback cables in various lengths are available from 
electronic supply houses and, in some cases, from your Apple dealer. 


A typical commercial cable assembly is shown in the photograph. 


DATA RATES 


The GPIB is a parallel bus which transmits eight-bit bytes of data at 
high data rates. The GPIB can also transmit blocks of commands or 
data, one byte at a time. Block transmission allows rapid transfer 
of data with a minimum number of time-consuming handshake and control 
functions. In other words, control overhead is at a minimum. The 
average block size sent by a typical instrument is 13 bytes. A 
printer or disk drive is able to send or receive an entire line or 
sector in a single block. 


The theoretical maximum rate of data transfer over the bus is 

one megabyte per second. The practical maximum is approximately 
25¢ kilobytes per second during a Direct Memory Access (DMA) 
operation. Usually, a DMA requires so much time to set up that the 
speed advantage is lost for the short blocks of data usually 
transferred in GPIB operations. 


The typical data rate for instruments on the bus is about one to two 
kilobytes per second. The operation of the GPIB is most efficient, 
and program overhead is minimized if all of the devices on the bus 


have buffered inputs; that is, if they can accept a block of data as 
fast as the controlling Apple can send it. 
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ELECTRICAL REQUIREMENTS 


Ideally, devices on the bus that are not in use should be turned off 
to conserve energy and to increase the device’s operating life. 
However, the best compromise between ideal energy conservation and 


proper operation of the bus requires that only some of the devices be 
turned off. The rule of thumb is that the Apple itself, plus at 
least half the devices connected to it, must have power on. 


GPIB CONNECTIONS 


The interface bus consists of eight data lines and eight control 


lines. The organization of these lines on the standard bus cable is 
shown in Table 2-1. The mmemonic symbols given for the connections 
are explained in the following paragraphs. 


PIN SIGNAL 

1 DIO1 O) 

2 DIO2 

3 DIO3 

4 DIO4 

5 EOL 

6 DAV 24 12 
7 NRFD 23 11 
8 NDAC 5 43 
9 IFC 24 9 
1¢ SRQ 20 8 
11 ATN is a 
12 shield (earth ground) a 
13 DIO5 

14 D106 bs ; 
15 DIO7 . : 
16 DIO8 ” ‘ 
17 REN i : 
18 logic ground a2 ; 
19 logic ground 

2¢ logic ground 

21 logic ground 

22 logic ground 

23 logic ground © 

24 logic ground 


Table 2-1. Standard Bus Connector Pin Assignments. 
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DATA LINES 


There are eight data lines in the GPIB. The data lines are numbered 


DIO] (Data Input/Output 1) through DIO8 and correspond to the data 
bits @ through 7 used by the Apple. The data carried by the data 


lines is represented using active low or negative logic. In negative 
logic, a low (@ volt) level on a line corresponds to a True and a 
high (5 volt) level corresponds to a False. The interface card 
inverts the data before sending it to and after receiving it from the 
Apple; thus all the data the Apple sends and receives is positive 
true logic. 


MANAGEMENT CONTROL LINES 


The GPIB uses eight lines to control the devices on the bus and to 
direct the flow of data on the bus. Five of the control lines are 
used for the management of data transfers. The remaining three 
control lines are used for handshaking, or coordination of the 
transfer of individual bytes of data. A brief description of the 
five management control lines is given below. The mnemonic name for 
each signal is followed by its meaning. 


The signals of all control lines are active low; that is, a line is 
considered to be active, or True, when its value is low (@ volts). 


For most applications you need not know which control lines are used 
with each command. The appendix on bus input/output sequences pives 
examples of the protocol used by each command. 


ATN ATteNtion 


The controller (Apple) indicates that an address or control byte is 
being placed on the bus by setting the ATN line true. The ATN line 
is set false to allow a device to place data on the buse The ATIN 


line is also used with the EOI line to initiate a parallel poll. The 
ATN line is set synchronously with the control handshake to eliminate 
confusion between control and data bytes. 


EOL End Or Identify 


The EOL signal has two uses. 1) The controller (Apple) sets EOI true 
and ATN true to initiate a parallel poll. 2) A talker will set EOI 
true with the last byte of data to indicate the end of the 
transmission. Unfortunately, not all available devices use the EOI 
to end a transmission. 
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SRQ Service ReQuest 


The SRQ signal is set true by any device on the bus which requires 
some action from the controller. Upon reception of the SRQ signal, 
the controller software places the address of each device in turn 
(serial poll) on the data lines of the bus. Each device returns one 
status byte. When the device that set SRQ true detects its address 
on the bus, it identifies itself by returning a status byte with DIO7 
true, and then it releases the SRQ line. 


IFC InterFace Clear 


The IFC signal is used by the controller (only) to set all device 


interfaces to a known initial state. This signal is used by the 
Abort command only. 


REN Remote ENable 


The REN signal is used by the controller (only) to allow a device to 
be remotely controlled. The device remains remotely controlled as 
long as the REN signal remains true. The device will not respond to 
data sent on the bus unless the REN signal is true. 


TRANSFER CONTROL LINES 


Data transfer on the bus is controlled by the three transfer control 
lines. The three lines use a three-wire handshake system (patented 
by Hewlett-Packard). The handshake system is asynchronous, allowing 
devices with both fast and slow data rates to operate on the same 
bus. The three-wire handshake is used to transfer every byte of 
information that is passed over the data lines. The three transfer 


control lines are described below. A diagram of the handshaking 
protocol is shown in figure 2-4. 


NRFD Not Ready For Data 


The NRFD signal is set true (low) by a listener to indicate that it 
is not yet ready for the next data or control byte. The NRFD signal 
at the controller will not be sensed as false (that is, ready for 
data) until all listeners on the bus are ready. 


NDAC Not Data ACcepted 


The NDAC signal is set true (low) by a listener to indicate that it 
has not yet accepted the data or control byte on the data bus. The 
NDAC signal at the controller will not be sensed as false (that is, 
data accepted) until all listeners on the bus have accepted the data. 
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DAV DAta Valid 


The DAV signal is set true (low) by a talker to indicate that a data 
or control byte is on the data bus and is available to all listeners. 


1. Data No Longer Valid -- Talker lets DAV go 
high when it sees that all -listeners have 
accepted data (3). Talker may now change 
the data. 

2. Data Valid -- Talker sees all listeners 
are ready for data (5). It pulls DAV low 
when the new data is ready. 

Data Accepted -- The last listener has 
accepted the data and then released NDAC. 
Acknowledge Data Not Valid -- The first 
listener that sees that data is valid (2) 


pulls NDAC low. 
: : 5. Ready For Data -- The last listener has 
seen that data is no longer valid (1) and 


has released NRFD to show that it is 
ready to accept data. 

6. Not Ready For Data ~- The first listener 
to accept data after data becomes valid 
(2) pulls NRFD low. 

7. When it sees that data is not valid (1), each listener pulls NDAC 
low (4) and simultaneously releases NRFD (5). 

8. When it sees that data is valid (2), each listener pulls NRFD low 
(6) and simultaneously releases NDAC. 
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Figure 2-4. Three-wire Handshaking Protocol. 


GPIB FUNCTIONS 


The Apple II GPIB has eleven general functions which control devices on 
the bus and transmit data. Every IEEE-488 compatible device is able 

to perform at least one of these functions. Please note that not all 
of the devices you may want to use on the bus will be able to use all 
of these functions. The general functions are briefly described in 

the following paragraphs. 


SH1 Source Handshake 
The source handshake function uses the three transfer lines to allow 


a talker (other than the controller) to transfer data to one or more 
listeners or the Apple on the bus. 
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AH1 Acceptor Handshake 


The acceptor handshake function uses the three transfer lines to 


allow a listener to accept data from a talker which is usually the 
Apple. 


T3 BASIC Talker 


The controller uses the control and data lines to address a device on 
the bus and enable the device to be a talker. When a device is 
enabled as a talker, the device can send status and data bytes on the 
bus. This function name has no relationship to the BASIC language. 


Ll BASIC Listener 


The controller uses the control and data lines to address a device on 


the bus and enable the device to be a listener. When a device is 
enabled as a listener, the device can receive commands and data from 
the bus. This function name has no relationship to the BASIC 
language. 


C4 Respond to Service Request 


The service request function uses the SRQ control line to notify the 
controller (the Apple) of action required. 


C3 Remote Enable 


The remote enable function will enable a device to be controlled by 
the Apple rather than by the device front panel controls. 


C25 Parallel Poll 


The parallel poll function uses the eight data bus lines to 

poll up to eight devices on the bus simultaneously. A parallel poll 
is used to determine whether a device needs to be serviced by the 
Apple, and if so, which device. The parallel poll is much faster 
than the service request function, but requires that the Apple 
conduct frequent parallel polling operations. Many currently 
available devices do not have parallel poll capabilities. 


DC Device Clear 


The device clear function permits the controller to clear or 
initialize (set to a known state) a device on the bus. The device 


clear function is separate from the interface clear function, which 
is controlled by the IFC line. 


IEEE-488 INTERFACE CARD 17 


C2 Interface Clear 


The interface clear function is used to set the GPIB interface card 
controller circuit, and all devices, to a known state prior to use. 


DT Device Trigger 


The device trigger function is used by the controller to synchronize 
the operation of one or more devices on the bus. The Apple can 
initiate a group execute trigger (GET) to synchronize a number of 
devices on the bus. The group execute trigger is not to be confused 
with the GET instruction in BASIC. 


cl Controller 


The controller function allows the controlling device (the Apple) to 
send addresses and universal and addressed commands to the devices on 
the bus. Only one system controller is allowed on the bus. The 
Apple is the system controller. 
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CHAPTER 3 
PROGRAMMING THE GPIB 


This chapter contains the programming concepts necessary to write a 
BASIC program for the GPIB. It begins with a section which explains 
a little about how the bus works, and how devices generally expect 
the bus to operate. Next is a summary of the addressing scheme used 
by the Apple II GPIB, followed by an in-depth description of each 
command that is available on the GPIB. The final section of the 
chapter discusses error messages and their causes. 


GETTING STARTED 


This section briefly explains how to get started programming the 
IEEE-488 card, some common features of different instruments, and 
what you should look for in the documentation of the instrument you 
are interfacing to the bys. It is a general introduction to the 
bus commands that are described later. All commands referred to in 
this section will be explained later. 


Before you can use the bus, you must issue a PR#n or IN#n command 
(for the IEEE-488 card in slot n). Every time a PR#n or IN#n is 
used, the default settings of the card are set to the following 
values: screen off (SC@), linefeed off (LF@), device number 9 (DVQ), 
and end of string character equal to carriage return (<CR>). If, for 
example, you do a PR#@ and IN#@ to ask a question of the operator, 
and then wish to direct I/O back to the card without first resetting 
the default values, you may use the subroutine in Program 3 of 
Appendix D. 


The format of the output data generally differs from one device to 
another. Some devices send out a <CR><LF> at the end of a string, 
while others send out only a <CR>. The appropriate linefeed command, 
LFl or LF@, must be used to ensure proper reception of the data. 
Some devices send out commas or:‘colons as delimiters between strings 
of data, or between a function code and a data string. Applesoft 
terminates input of the current string when one of these characters 
is detected; therefore, for each comma or colon in the input string, 
the INPUT statement must have an additional variable. If the number 
of commas or colons sent by the device is variable, you may want to 
use the subroutine, Input With Commas, in Program 4 of Appendix D. 


Some devices must be initialized with certain commands before they 
can be used for input. Some instruments require a <CR><LF> for 
setup, and others just need a <CR>.} Some devices must be set into 
"remote" mode before they will respond to commands sent on the 
IFFE-488 bus, others require "local lockout" mode as well. The 
commands RA, RM, LA, LL and LO are used to set devices to these 
different modes. 
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Certain instruments must receive a trigger command (TG) before they 
will send a reading to the bus. The data is usually latched into the 
instrument at the time of the trigger, and held until it is read by 
some device on the bus. The read operation clears the latch until 
another trigger command is issued to that device. Some instruments 
might give false readings if they are not triggered before they are 
read. 


Other commands are used to put the bus and the instruments on it into 
a known state. These commands are CA, CL, UT and AB. They will 
reset certain of the instrument’s modes, usually those which 
determine whether the device is set up to receive or to send data. 


These are all typical conditions which need to be attended to when a 
device is being used on the bus. In all cases the instrument’s 


instruction manual will explain exactly which commands the device 
must receive in order to operate properly. 


Because this section deals with commands that you know very 
little about, we suggest that you re-read it after you have 
studied the command descriptions later in this chapter. 


COMMAND NOTATION 


The standard form of an GPIB command is a string of characters; each 
character is a / bit ASCII code as sent by the Apple keyboard. Each 
character is sent or received in the low seven bits of one bytee The 
general format of a command string is 


<command> <control characters> <data> 


The <command> is a two letter mnemonic device used to execute one of 
the GPIB commands. The <control characters> and <data> parameters 


are required by some of the commands, and not required by others. 


The commands used by the GPIB are summarized in Table 3-l. The left 
column lists the command names; the column labelled FORMAT lists the 
form of each command string in Backus-Naur Form (BNF); and the column 
labelled BASIC lists the BASIC command (PRINT or INPUT) that must be 
used to send the command. 


All GPIB commands are sent by BASIC to the IEEE-488 card. Depending 
on the command sent, the card may or may not transfer data on the 
bus. The rightmost column of Table 3-1, labelled BUS?, says YES if 
the command in that row of the table causes data to be placed on or 
read from the bus. 


BNF descriptions of the <control characters> and <data> portions of 
the command strings are given in Table 3-2. Every bracketed 
component, called a descriptor, is defined in Table 3-2 in terms of 
ASCII characters and other descriptors. 
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In BNF notation, a symbol that is not enclosed in brackets should be 
included in the command string literally. A descriptor enclosed in 
brackets is used to represent an element, or list of elements, that 


must occupy that position in the command string. Descriptors that 
are separated by a vertical bar (|) are interchangeable. A vertical 


bar may be read as the English word "or". 


For clarity, elements of the command string are separated by 


Spaces, both in the tables and in the individual command 
descriptions later in the chapter. Actual command strings 
must not contain these spaces since a space can be interpreted 
as the address of a listener. 


In Table 3-2, note especially that the <listen list> and <count> 
parameters must be terminated by the character <CTRL-Z>. This may 
not be obvious from Table 3-1. Note also the use of the symbols 
<CTRL-Z>, <CR>, and <SP>. These symbols refer to pressing Z while 
holding down the key labelled CTRL, pressing the key labelled RETURN, 
and pressing the spacebar, respectively. 


Tables 3-1 and 3-2 are also included in the reference card in the 
back of the manual. 
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Table 3-l. 


COMMAND 
WRITE 
WRITECNT 
READ 
READCNT 
XFER 
TRIGR 
CLRAL 
CLEAR 
REMAL 
REMDV 
LLKAL 
LOCAL 
" LOCDV 
SRQD 
SPOLL 
PPOLL 
PPENB 
PPDIS 
PPUAL 
ABORT 
LINEFEED 
EOS 
SCREEN 
DEVICE 


UNTALK 


GPIB Command Summary. 


WT 


WC 


TG 


CA 


LL 


DV 


UT 


FORMAT 
<listen list> <data> <E0OS> 
<listen list> <count> <data> 


<talker> <CTRL-Z> <data> <term> 


<talker> <CTRL-Z> <count> <data> <term> 


<talker> <CTRL-Z> <listen list> <CR> 
<listen list> <CR> 

<CR> 

<listen list> <CR> 

<CR> 

<listen list> <CRD> 

<CR> 

<CR> 

<listen list> <CR> 

<srq> <CR> 

<talker> <CTRL-Z> <status word> <CR> 
<status word> <CR> 

<enable list> <CR> 

<listen list> <CR> 

<CR> 

<CR> 

<off/on> <CR> 

<EOS> <CR> 

<off/on> <CR> 

<device number> 


<CR> 


22 IEEE-488 INTERFACE CARD 


BASIC 


PRINT 


PRINT 


INPUT 


INPUT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


INPUT 


INPUT 


INPUT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


BUS? 


Table 3-2. GPIB Command String Definitions. 


<lf{aten list> ::= <CTRL-Z> | <listener> <CTRL-Z> | <listener> <listen list> 


<listener> ::= <primary listener> | <primary listener> <secondary address> 
* <primary listener> ::= <SP> |! |" | #... >| ? 
* secondary address> ::= ’ | a [| b{[c eee } {| ~ 


<count> ::= <decimal digit> <CTRL-Z> | <decimal digit> <count> 
NOTE: The maximum total value for count is 255. 


<EOS> ::= any ASCII character 


<data> ::= empty | any ASCII character | any ASCII character <data> 
<talker> ::= empty | <primary talker> | <primary talker> <secondary address> 
* <primary talker> ::= @|AJIBIC woe * |] _ 
* <hex digit> ::= @ |] 1 12..9 | AlBeoe F 
* <decimal digit> ::= @ f]1 {12... 9 
<status word> ::= <hex digit> <hex digit> 
<srq> ::= ASCII “"T" | ASCII "F" 


<term> ::= empty | <CR> | <EOS> | EOI 
NOTE: empty if last char = <CR> or <CR><LFD> 


<device number> ::= <decimal digit> <decimal digit> 
NOTE: Maximum device number is 39 


<off/on> ::= ASCII "9" | ASCII "1" 
<enable list> ::= <listener> <enable> | <listener> <enable> <enable list> 


* <enable> ::= @ | A[ B.eee N]{O 


<CR> 3: ASCII carriage return (13 decimal) 


<LF> ::= ASCII linefeed (19 decimal ) 
<SP> ::= ASCII space (32 decimal) 
<CTRL-Z> ::= ASCII SUB (26 decimal) 
<CTRL-D> ::= ASCII ET (4 decimal) 


* NOTE: Marked elements are ASCII characters. 
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ADDRESSES 


There are three types of addresses which may be included as part of 
the <control characters> parameter. These address types are: | 
listener address, talker address and secondary address. Each address 
is specified by a distinct character corresponding to one of the 
ASCII codes. Address characters referenced in the following text 

are enclosed in quotation marks. 


LISTENER ADDRESSES 


The addresses of all listeners on the GPIB are restricted to the hex 
values 2% through 3E. The listener address range corresponds to 
ASCII characters (as sent from the keyboard) from <SP> through ">". 
The decimal, octal, and hexadecimal values of each possible listener 
address are shown in Table A-l of Appendix A. Hex value 3F (ASCII 
"2") is reserved as a special universal UNListen (UNL) command which 
is automatically sent by the Apple II GPIB when needed. 


TALKER ADDRESSES 


There may only be a single talker at a time. The address of the 
talker on the GPIB is restricted to the hex values 49 to 5E. The 
talker address range corresponds to ASCII characters (as sent from 
the keyboard) from "@" through "*". The decimal, octal, and 
hexadecimal values of each possible talker address are given in Table 
A-2 of Appendix A. Hex value 5F (ASCII "_") is reserved as a special 
universal UnTalk command which is sent with the UT command. 


SECONDARY ADDRESSES 


Secondary addresses may be used to set operating features of some 
devices. They may also be used to address subunits of a complex 
device. For instance, the operating range and measurement type for 
some remote digital voltmeters may be set from the Apple by means of 
secondary addresses. 


The GPIB provides the capability of sending a secondary address to 
either talkers or listeners. Secondary addresses are included as 
elements of the <talker> or <listen list> parameters if they are 
needed. A secondary address must immediately follow the primary 
address with which it is associated. 


Secondary addresses on the GPIB are restricted to the hex values 69 
through 7E. The secondary address range corresponds to ASCII 
characters (as sent from the keyboard) from "’" through "~". The 
decimal, octal, and hexadecimal values of each possible secondary 
address are shown in Table A-3 of Appendix A. 


From APPLESOFT, the characters needed for secondary addresses are not 
directly available from the keyboard. They can, however, be 
generated using the CHRS function. The proper CHR$ calls are shown 
in Table A-3 of Appendix A. Examples of the use of this function are 
given in the examples of the commands. 
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From Integer BASIC, a special subroutine must be used to generate 
secondary addresses. This subroutine is listed in Program 1 of 
Appendix D. 


ON USING ADDRESSES 


You must carefully read the operating manual of the device you are 
planning to use with the GPIB, to ensure that you understand the 
addressing method used by that device. The device’s addresses might 
be preset by factory-installed jumpers, or they might be adjustable 
using addressing switches. It is important that you determine what 
address values the manufacturer intended the device to have. 


The address for the device may be given in binary, hex, octal, or 
ASCII. You must determine what character, when sent from the Apple 
keyboard, will represent that address. If the address is not 
hard-wired, you should set the address switches or jumpers to a 
convenient address. Tables of addresses are given in Appendix A. 


Each device has associated with it a device number assigned 
by the manufacturer or set as explained above. The device number is 
only used internally to the IEEE-488 card. 


Be sure that no instrument has the same device number as the 


Apple. The default device number for the Apple is 9. Device 
number @ (not ASCII @) corresponds to a listener address <SP> 
and a talker address "@". 


GPIB COMMAND DESCRIPTIONS 


Table 3-1 lists all the commands that you can send to the Apple [I 
GPIB. There are three types of commands: output commands, input 
commands, and commands used to set operating characteristics of the 
IEFEE-488 card. The last type does not cause any data to be placed on 
the bus; the others do. The two rightmost columns of Table 3-1 
indicate which type each command is. The column labelled BASIC tells 
which BASIC command, PRINT or INPUT, should be used to send the 
command in each row. 


SENDING A COMMAND 


Commands which send data to a device take the form 


PRINT "<command><control chars><data>" 


and commands which read data from a device take the form 


INPUT "<command><control chars>"; S$ 
or 

PRINT '"<command><control chars>"; 

INPUT S$ 
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in which S$ is a string appropriate for that particular command. 


A program that sends commands to the GPIB must first indicate the 
number of the slot into which the interface card is inserted. In the 


examples which follow, the slot number is assumed to be 3. The 
statement 


PR#3 


must precede the first statement in which you PRINT a command to the 
card. Likewise the statement 


IN#3 


must precede the first statement in which you INPUT data from the 


card. Quite simply, you are telling the Apple to talk to or listen 
to the Apple II GPIB, which is in slot 3 (in this case). 


A DOS command from a program must appear in a PRINT statement 


whose first output character is <CTRL-D> and whose output is 


separated from preceding and from succeeding printed output 
by <CR>s. 


Thus, if you are using DOS, the statements 


1g DS ="; REM A <CTRL-D> LIES BETWEEN THE QUOTES 
29 PRINT DS$;"PR#3" 
39 PRINT D$;"IN#3" 


must precede the first PRINT and INPUT statements to the card. The 
DOS form of the commands is the one that we will use in the following 
examples. 


The commands PR#n and IN#n have the effect of resetting all 
the card’s default values. The resetting of default values 
can be avoided with the subroutine in Program 3 of Appendix D. 


COMMAND PROTOCOL 


As previously noted, <listen list> and <count> must be terminated by 

the character <CTRL-Z>. For the following examples, assume that the 

variable Z$ has been set to the value <CTRL-Z> using one of the BASIC 
statements 


5 Z$ a : REM <CTRL-Z> IS BETWEEN THE QUOTES 
5 Z$ = CHR$(26) : REM CHRS$(26) IS <CTRL-Z> IN APPLESOFT 


and that DS has been set to the value <CTRL-D> as shown above. 
When using the GPIB with the SCREEN option set to ON, a <CTRL-Z> 


prints out as an inverse-video Z. See the SCREEN command later in 
this chapter for more details. 
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A command string is terminated by a <CR> or an end-of-string 
character, <EOS>. The PRINT command normally sends a <CR> as its 
last character. If <EOS> is not <CR>, or if you want to PRINT a 


string containing characters as well as variables, use the special 
symbol ";" to continue the PRINT statement without sending a <CR>. 


For example, to print the character sequence “WT1" followed by 
<CTRL-Z> and then AS, without <CR>s between them, use 


19 PRINT "WTL" 3; ZS 3; AS : REM THE VALUE OF ZS IS <CTRL-Z> 
This is equivalent to the statements 


19 PRINT "WTL"; 
11 PRINT Z$; 
12. PRINT AS 


It is, of course, possible to embed control characters into any 
string, but since embedded control characters are not visible, the 
above convention was adopted. 


BUS TRANSFERS 


When a command is executed by the GPIB, a sequence of data and 
control signals is transferred on the 16 data and control lines. 
Examples of the input/output sequences for all the GPIB commands are 
given in Appendix B. The bytes sent on the DIO lines are data and 
IEEE-488 commands. Refer to the IEEE standard for more details. 


GPIB COMMANDS 


The first four commands given below -- LINEFEED, EOS, SCREEN and 
DEVICE -- are commands that set operating characteristics of the 
card. Although these commands do not cause any data to be sent on 
the bus, some of them do have an effect on data that is sent over the 
bus by other commands. 


The rest of the commands cause some sort of data to be transferred 


over the bus: this data can take the form of information passed from 
one device to another, or it can take the form of commands that set 


Operating characteristics of the devices on the bus. 


LINEFEED: LF 


Linefeed Control. The LINEFEED command is used to set the board to a 
mode that will generate a line feed character (<LF>) after each 
carriage return (<CR>). The LINEFEED command takes the form 

LF <off = G/on = 1l> <CR> 


During WRITE commands issued while LINEFEED is set to on, the 
IEEE-488 card will send a <LF> following every instance of <CR> in 
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<data>, even if <data> already has a <LF> after each <CR>. The 
LINEFEED option does not affect the data sent by WRITECNT commands. 


During READ commands issued while LINEFEED is set to on, the IEEE-488 
card expects a <LF> to follow the terminating <CR>. 


The LINEFEED commands are as follows: 


19g PRINT DS;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
2¢ PRINT "LF1" (line feed character is provided after each <CR>) 


29 PRINT "LF@" (line feed character is not provided after each <CR>) 


LINEFEED is set to off when <EOS> is changed from <CR>. 


EOS: ES 


End Of String Character. The EOS command is used to change the 
character used to terminate a string. The EOS character is a <CR> 
under normal or default conditions. A reset or PR#3 instruction 
resets the EOS character to <CR>. LINEFEED is set to off when <E0S> 
is changed from <CR>. The EOS command is 


ES <EOS> <CR> 
The EOS command format is as follows: 


19 PRINT DS$;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
29 PRINT "ES!" 


This command changes the EOS character from <CR> to !. 


SCREEN: SC 


Screen Control. The SCREEN command is used to control the CRT 
display during operation of the GPIB. The CRT display shows all 
input and output characters when SCREEN control is on. The display 
is very useful during program debugging. The normal (default) 
condition of SCREEN is off. The SCREEN command takes the form 

SC <off = J/on = 1l> <CR> 
The SCREEN command is as follows: 


10 PRINT DS;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
26 PRINT "SC1" (data is displayed on the CRT display) 


29 PRINT "SCO" (data is not displayed on the CRT) 
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DEVICE: DV 


Controller Device Number. The DEVICE command is used to set the 
device number of the Apple controller. The normal or default device 
number of the Apple controller is G, and it will be reset to @ by a 
PR#n instruction, or by pressing RESET. The device number, used 
modulo 32, may be one or two ASCII decimal digits; if the number is 


99 or less, the leading 9 can be omitted. The device number 31 
(corresponding to 31,63,95...) may not be used because it is 


reserved for the UNLISTEN and UNTALK commands. The DEVICE command 
takes the form 


DV <device number> <CR> 


The DEVICE command follows: 


19 PRINT D$;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
29 PRINT "DVG1" 


WRITE: WT 


Write Data Out. The WRITE command sends data to all devices named in 
<listen list>. The WRITE command is the normal way of sending data 


from the Apple to one or more remote devices. The command takes the 
form 


WT <listen list> <data> <EOS> 


An EOI (End-Or-Identify) bus signal is automatically sent with the 
last <EOS> character. A <CR> is the normal <EOS>. If the LF flag is 
set (see the LF command), and the <EOS> character is <CR>, then EOI 
is sent with the <LF>. Sample WRITE commands follow: 


16 DS;"PR#3": REM THE VALUE OF DS IS <CTRL-D> 
39 PRINT "WT1"; ZS; AS : REM THE VALUE OF Z$ IS <CTRL-Z> 


This command sends the string of data, A$, to the listener with 
address equal to the value of keyboard character 1 (49 decimal, 61 
octal or 31 hex). 


40 PRINT "WT8"; CHRS(97); Z$; A$ : REM THE VALUE OF Z$ IS <CTRL-Z> 


This command sends the string of data, A$, to the listener with 
primary address "8" and secondary address "a'"'. The CHRS function must 
be used to send lower-case characters such as "a" from the Apple 
keyboard. The CHRS functions are listed in table A-3 of Appendix A. 
The ASCII code for "a" is 97, so CHRS$(97) generates an "a". 


Program 1 in Appendix D shows how lower case characters can be sent 
from Integer BASIC. 
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WRITECNT: WC 


Write Data Out With Counte The WRITECNT command is like a WRITE 


command that includes a count of the number of bytes in the data 
string. The command takes the form 


WC <listen list> <count> <data> 


The <EOS> character (nominally <CR>) is not normally sent at the end of 
the data string, but the bus signal EOI is sent with the last 


character. The count must be greater than 9 and less than 256. A 
sample WRITECNT statement follows: 


10 D$;"PR#3": REM THE VALUE OF D$ IS <CTRL-D> 
26 PRINT "WCl"; Z$; LEN(B$); Z$; B$; :REM THE VALUE OF Z$ IS <CTRL-Z> 


This command sends the string BS of length LEN(BS$) to the listener 
with address "1". 


One important use of the WRITECOUNT comand is to send data 
that is not terminated by the <EOS> character. This cannot be 
done with the WRITE command. 


Any extra characters beyond the count will be interpreted as a 


new command and will cause an error. Too few characters will 
cause the next command to be sent as part of the data string 
and will cause an error. If the PRINT statement is not 
terminated by a "3", a <CR> will be automatically sent and must 
be included in the character count. Likewise, if LINEFEED is 
set, <CR><LF> must be included in the count. 


READ: RD 


Read Data In. The READ command receives data from a talker specified 
by the command. The READ command is the normal method of receiving 
data from a remote device. The command takes the form 


RD <talker> ZS <data> <term> 


The input data string terminates when a <CR> or <EOS> character 
(nominally a <CR>) is received, or when the EOI signal goes true. 
The IEEE-488 card will always return a <CR> to the program to 
terminate the input data. If the last character from the card is a 
<CR>, an additional <CR> will not be sent. A line feed character 
from the GPIB will be suppressed and not passed to the program. A 
sample READ command follows: 


5 DS;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 

19 D$;"IN#3" :REM THE VALUE OF D$ IS <CTRL-D> 

26 PRINT "RDA"; Z$; +: REM THE VALUE OF Z$ IS <CTRL-Z> 
25 INPUT C$ 
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This command receives the data string CS from the talker with 
address "A". 


5 DS;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
1¢ DS$;"IN#3" :REM THE VALUE OF DS IS <CTRL-D> - 


30 PRINT "RDA"; CHRS(98); ZS;  : REM THE VALUE OF Z$ IS <CTRL-Z> 
35 INPUT CS 


This command receives a data string C$ from the talker with address 


"A" and secondary address "b". The lower case "b" is generated by 
CHRS$(98). 


Note the use of the ";" following the last two PRINT 
statements. 


If a PRINT statement sends a command and an INPUT 
Statement reads the data placed on the bus because of that 
command, it is necessary to suppress the <CR> normally sent 
after the PRINT. 


READCNT: RC 


Read Data In With Count. The READCNT command is like the READ 


command with a field, count, that specifies the length of the input 
string in bytes. The command takes the form 


RC <talker> Z$ <count> <data> <term> 


EOI may be sent with the last character in the string by the talker. 


The data string may contain less than count characters if the talker 
uses EOI or <EO0S>. 


The IEEE-488 card will always return a <CR> to the program to 


terminate the input-data. If the last character from the card is a 
<CR>, an additional <CR> will not be sent. An example of a READCNT 
command follows: 


9 DS$;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
1g DS;"IN#3" :REM THE VALUE OF DS IS <CTRL-D> 


20 PRINT "RCB"; ZS; "26"; ZS; : REM THE VALUE OF ZS IS <CTRL=-Z> 
25 INPUT CS 


This command receives the data string C$, containing 26 characters, 
from the talker with address "B". 


If you are using the RC or RD command with the LINEFEED 


option set (see the LF command), be sure that the device does 
not send a NULL (ASCII 9G) when the GPIB is expecting a <LF>. 
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XFER: XF 


Transfer Data. The XFER command is used to transfer data between 
remote devices other than the Apple. The talker is addressed first, 


followed by the listeners. The device address of the Apple 
(nominally @) must NOT appear as the talker or in the listen list. 


The XFER command takes the form 
XF <talker> ZS <listen list> <CR> 


The talker MUST be programmed to send EOI with the last character 
in the transfer. This tells the listener(s) that the transfer is 
complete, and allows the Apple to regain control of the GPIB. A 
sample XFER command follows: 


1¢ PRINT DS;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
29 PRINT "XFA"; ZS; "1"3 ZS 


This command allows the talker with address "A" to transfer data 
directly to the listener with address "1". 


TRIGR: TG 


Group Execute Trigger. The TRIGR command is used to configure or 
set up a group of remote devices on the GPIB and to cause all of the 


devices to commence execution at the same time. The command takes 
the form 


TG <listen list> <CR> 
A sample TRIGR command follows: 


1¢ PRINT D$;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
2¢ PRINT "TG"; "19"; ZS ; 


This command causes listeners with addresses "1" and "9" to be 
triggered simultaneously. 


CLRAL: CA 


Clear All Devices. The CLRAL command issues a universal clear 
message to all remote devices on the GPIB. The command format is 


CA <CR> 
An example of the CLRAL command is 


1¢ PRINT DS$;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
2¢ PRINT "CA" 


This command clears all devices on the GPIB. 
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CLEAR: CL 


Clear Selected Devices. The CLEAR command clears the remote devices 
specified by the address list. The command takes the form 


CL <listen list> <CRD> 
A sample CLEAR command follows: 


19 PRINT D$;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
29 PRINT "CL"; "19"; ZS 


This command issues a clear message to the remote devices with 
addresses "1" and "9", 


REMAL: RA 


Remote Enable All. The REMAL command is used to set the REN (remote 
enable) control line true. The remote devices will not be in remote 
operating mode until addressed to listen. The REMAL command is 


RA <CR> 


An example of a REMAL command follows: 


1g PRINT D$;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
2¢ PRINT "RA" 


All subsequent listen addresses will be sent with the REN 
signal true. The REN signal is not set to false until the LA 
command is sent. 


REMDV: RM 


Remote Enable Selected Devices. The REMDV command is used to set 
the REN (remote enable) line true and to send the address of the 
specified listeners on the GPIB. The listeners are placed in remote 


mode when addressed. The command takes the form 
RM <listen list> <CRD> 
A sample REMDV command follows: 


19 PRINT DS$;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
15 ES = "12349" + 7$ 


26 PRINT "RM"; ES 


This command turns on remote operation of the devices with addresses 
hd Fea Aaa BLS Sa he and Ng. 


All subsequent listen addresses will be sent with the REN 


signal true. The REN signal is not set to false until the LA 
command is sent. 
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LLKAL: LL 


Local Lockout All Devices. The LLKAL command is used to set all 
remoted devices on the GPIB to local lockout mode. The front panel 
controls of a remote device have no effect (e.g. if someone presses 


the instrument’s RESET button) when the device is in local lockout 
mode. The LLKAL command follows: 


LL <CR> 
Here is an example of the LLKAL command 


1¢ PRINT DS;"PR#3" :REM THE VALUE OF DS IS <CTRL=D> 
29 PRINT "LL" 


LOCAL: LA 


Local Mode All Devices. The LOCAL command is used to set all remote 
devices on the GPIB to local operating mode. The command byte takes 
the form 


LA <CR> 


The LOCAL command will set the REN control line false. A LOCAL 
command follows: 


1G PRINT DS;"PR#3" :REM THE VALUE OF DNS IS <CTRL-D> 
29 PRINT "LA" 


LOCDV: LO 


Local Mode Selected Devices. The LOCDV command is used to set 
selected remote devices to local operating mode. The LOCDV comnand 
takes the forn 

LO <listen list> <CRD> 
A sample LOCDV command follows: 


19 PRINT D$;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
29 PRINT "LO"; "12349"; Z$ 


This command sets local operating mode for the remote devices with 
addresses ae DW. ua. "AN snd "QO", 
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SRQD: SR 


service Requested.e The SRQD command is used to determine whether 
uny remote device on the GPIB is requesting service. The command 
will return the value of ASCII T (84 decimal, 124 octal, 54 hex) if 
the SRQ control line is true. The command will return the value of 
ASCII F (7G decimal, 196 octal, 46 hex) if the SRQ control line is 
false. The SRQD command takes the form 


SR <srq> <CR> 
The SRQD command follows: 


5 PRINT DS;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
1¢ PRINT DS;"IN#3" :REM THE VALUE OF DS IS <CTRL-D> 
20 INPUT "SR"; GS 


The value returned in G$ is either a "T" or a "F", 


SPOLL: SP 


Serial Poll. The SPOLL command is used to send a serial poll to an 
addressed remote device on the GPIB. The SPOLL is usually used when 
a "T" has been returned as the result of an SRQD command. The 


addressed remote device will return a status byte which will 
determine if that device has requested service. The IEEE-488 card 
translates the status byte into a 2 byte status word. The form of 
the SPOLL command is 


SP <talker> ZS <status word> <CR> 
A sample SPOLL command follows: 
5 PRINT DS$;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
1¢ PRINT DS$;"IN#3" :REM THE VALUE OF DS IS <CTRL-D> 


20 PRINT "SPA"; ZS; 
39 INPUT HS 


The value returned in H$ is a status word from the remote device with 
address "A". HS is two bytes long. The first byte is the ASCII form 


of the most significant four bits of the binary status byte, 
representing a hexadecimal number between @ and F. The second byte 
is the ASCII form of the least significant four bits of the binary 
atatus byte. <CTRL-Z> will not be displayed on the screen during 
SPOLL command. The value of the status byte returned by a device is 
determined by the manufacturer of that device. 


If the addressed device was asserting SRQ, it will stop doing so and 
it will return the status byte with DIO7 asserted. This implies tha 


the first character of HS will be a 4, 5, 6, 7, C, D, E, or F. The 
moaning of other DIO bits is device dependent. 
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PPOLL: PP 


Parallel Poll. The PPOLL command is used to conduct a parallel poll 
of remote devices. The result of the parallel poll is to return an 
eight bit status byte to the IEEE card. Each of the eight bits may 
be assigned to a device using the PPENB command for some devices, or 
by a DIP switch on devices that implement the PP2 subset of the 
IEEE-488 standard. The IEEE-488 card translates the status byte into 
a 2 byte status word. The form of the PPOLL command is 


PP <status word> <CR> 
A sample PPOLL command follows: 


5 PRINT DS$;"PR#3" :REM ‘THE VALUE OF DS IS <CTRL-D> 
19 PRINT DS;"IN#3" :REM THE VALUE OF DS IS <CTRL-D> 
29 INPUT "PP"; IS 


The value returned in I$ is a two byte status word. The first byte 
is the ASCII form of the most significant four bits of the binary 
status byte, representing a hexadecimal number between @ and F. The 
second byte is the ASCII form of the least significant four bits of 
the binary status byte. 


PPENB: PE 


Parallel Poll Enable. The PPENB command is used to set the 
configuration of remote devices which can implement the PP1 subset of 
the IEEE-488 standard. The command is used to assign a bit number 
and bit sense for each remote device to be enabled. 


PE <enable list> <CR> 


An element of the enable list consists of a listener address followed 
by an enable byte. The enable byte takes the form 9 1994S P3PoP,. 

Bit "S" of the enable byte assigns the sense of that listener’s poll 
bit in the status byte (see above); that is, whether the device will 
signal a request for service with a l or a G@. Bits Pg Php, treated 

as a number from @ through 7, determine which bit of the status byte 
is assigned to that device. The enable byte corresponds to an ASCII 


character in the range "@" to "0". To conform with the IEEE 
standard, the IEEE-488 card ORs the status byte with a hexadecimal 29 


before sending the byte on the bus. A sample PPENB command follows: 


19 PRINT D$;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
29 PRINT "PE"; "1A2B3K4L" 


The sample command results in the following configuration 


Listener "1" signals requests with status bit 1, sense = 
Listener "2" signals requests with status bit 2, sense 
Listener "3" signals requests with status bit 3, sense = 
Listener "4" signals requests with status bit 4, sense = 


It 
—= m= GQ 
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PPDIS: PD 


Parallel Poll Disable. The parallel poll disable is used to prevent 
the listed remote devices from responding to parallel poll commands. 
The PPDIS command takes the form 


PD <listen list> <CR> 


A sample PPDIS command follows: 


19 PRINT DS;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
29 PRINT "PD"; "1234"; Zs 


This command prevents the listeners with addresses "1", "2", "3" and 
"4" from responding to parallel poll commands. 


PPUAL: PU 


Parallel Poll Unconfigure All Devices. The PPUAL command is used to 


change the configuration of remote devices in order to prevent future 
responses to parallel polls. The PPUAL command is 


PU <CR> 


The PPUAL command is shown: 


19 PRINT DS$;"PR#3" :REM THE VALUE OF DS IS <CTRL~D> 
29 PRINT "PU" 


ABORT: AB 


Clear All Interfaces. The ABORT command is used only in cases of 
emergency to clear all device interfaces. It resets all devices to a 
known state by setting the IFC control line to true. The IFC pulse 
lasts for about 5 milliseconds. The ABORT command follows: 


16 PRINT D$;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
26 PRINT "AB" 


Untalk. The UNTALK is used to send the Universal Untalk (CUNT) 
command. This command is required for some remote devices. 
Carefully read the device’s operating manual for actual requirements. 
The UNTALK command follows: 


1¢ PRINT D$;"PR#3" :REM THE VALUE OF DS IS <CTRL-D> 
29 PRINT “UT" 
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GPIB ERROR MESSAGES 


When the GPIB encounters a stream of characters which it cannot 
understand, it issues an error message to the console. Execution of 
the program is terminated unless the BUS error occurs when the ONERR 
flag is set. There are four different error messages which are 
listed below along with typical causes of that particular error. 


When displayed on your screen, the three letter error type is 
followed by the letters "ERR". 


CMD — The first two characters of the command were not recognized as 
one of the GPIB commands. This could happen accidentally if, for 
example, <EOS> is no longer <CR> and a previous WRITE command didn’t 
use a semicolon to suppress the final <CR>. It could also be caused 
by an unexpected comma, causing termination of input, in an input 
string. Another cause of the CMD error is the occurrence of a system 


error during an input command. The system error message starts with 
a "2?" which is interpreted as an invalid command character. 


LST -- The control characters and/or data do not follow the 
protocol required by the command being used. This error is typically 
caused by an omitted <CTRL~Z> or consecutive secondary addresses. 


CNT -~ The count is out of range (usually 2 256). This error can 
only occur with the WC, RC and DV commands. 


BUS -- Incomplete source handshake error. It occurs if a byte is 
placed on the GPIB when NDAC and NRFD are both high. This situation 
will occur when the bus is improperly connected or if the addressed 


device is off. A BUS error can be recovered using the ONERR...GOTO 
statement. 


THE ONERR . . . GOTO STATEMENT 


Of the four error conditions that the GPIB can detect, only the BUS 


error is recoverable. If you are using APPLESOFT and your program 
includes an 


ONERR GOTO linenum 


statement, the GPIB firmware will detect the ONERR flag, and then 


transfer control to the proper place in the APPLESOFT firmware. 
APPLESOFT will then transfer control to linenum, as if a normal 


APPLESOFT error had occurred. You may insert any type of error 


recovery routine at the line indicated by linenum. A sample error 
routine is listed in Program 2 of Appendix D. 


See the APPLESOFT II BASIC Programming Reference Manual for more 
details on the ONERR...-.GOTO statement. 
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APPENDIX A. 


ASCII CONVERSION TABLES 


DEC 
OCT 
HEX 


ASCII decimal code 
ASCII octal code 


ASCII hexadecimal code 
CHRS = Applesoft function 


TABLE A-1 GPIB LISTENER ADDRESSES 


DEC 


OCT 


G49 
G41 
G42 
943 
G44 
G45 
G46 
G47 
G59 
G51 
G52 
$53 
G54 
G55 
956 
G57 
G69 
$61 
962 
$63 
964 
965 
966 
667 
879 
$71 
$72 
$73 
G74 
$75 
976 
$77 


HEX 


CHAR WHAT TO TYPE 


SPACE space 
! ! 
w " 
if if 
$ $ 
vA he 
é é 
( ( 
) ) 
* * 
+ + 
> > 
/ / 
d g 
1 1 
2 2 
3 3 
4 4 
5 5 
6 6 
7 7 
8 8 
9 9 
3 3 
< < 
> > 
? Reserved for UNLISTEN 
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TABLE A-2 GPIB TALKER ADDRESSES 


DEC OCT HEX CHAR WHAT TO TYPE 
64 169 4G @ @ 

65 161 41 A A 

66 162 42 B B 

67 193 43 C C 

68 104 44 D D 

69 195 45 E E 

79 196 46 F F 

71 197 47 G G 

72 119 48 H H 

73 lll 49 I I 

74 112 4A J J 

75 113 4B K K 

76 114 4C L L 

77 115 4D M M 

78 116 4E N N 

79 117 GF O 6) 

8¢ 12¢ 59 P P 

81 121 51 Q Q 

82 122 52 R R 

83 123 53 S) S 

84 124 54 T T 

85 125 55 U U 

86 126 56 V V 

87 127 57 W W 

88 13¢ 58 X X 

89 131 59 Y Y 

9¢ 132 5A Z Z 

91 133 5B [ CHRS$(91) 
92 134 5C \ CHRS$(92) 
93 135 5D ] ]) (Cshift-M) 
94 136 5E s . 

95 137 5F Reserved for UNTALK 
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TABLE A-3 GPIB SECONDARY ADDRESSES 


DEC Oct HEX CHAR WHAT TO TYPE 
96 149 69 ¢ CHRS(96) 
97 141 61 a CHRS(97) 
98 142 62 b CHRS$(98) 
99 143 63 c CHRS$(99) 

199 144 64 d CHRS(199) 

191 145 65 e CHRS$(191) 

192 146 66 f CHRS$(192) 

193 147 67 g CHRS$(193) 

194 15d 68 h CHRS$(104) 

165 151 69 i CHRS$(15) 

196 152 6A j CHRS$(196) 

197 153 6B Ik CHRS (107) 

198 154 6C 1 CHRS$ (168) 

199 155 6D m CHRS(199) 

11 156 6E n CHRS$(119) 

111 157 6F O CHRS$(111) 

112 169 79 p CHRS(112) 

113 161 71 q CHRS$(113) 

114 162 72 r CHRS$(114) 

115 163 73 S CHRS$(115) 

116 164 74 t CHRS(116) 

117 165 75 u CHRS$(117) 

118 166 76 v CHRS$(118) 

119 167 77 Ww CHRS$(119) 

129 17 78 x CHRS(129) 

121 171 79 y CHRS$(121) 

122 172 7A zZ CHR$(122) 

123 173 7B { CHRS$(123) 

124 174 7c CHRS(124) 

125 175 7D } CHRS$(125) 

126 176 7E = CHRS(126) 
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TABLE A-4 ASCII CONTROL CODES 


42 


DEC = CT. 
G 099 
1 G91 
2 G92 
3 093 
4 G94 
5 G95 
6 G96 
7 007 
8 G19 
9 911 

1g G12 

iy 913 

12 G14 

13 G15 

14 G16 

15 G17 

16 929 

17 921 

18 $22 

19 923 

29 G24 

21 $25 

22 $26 

23 G27 

24 939 

25 931 

26 $32 

27 933 

28 G34 

29 935 

39 $36 

31 937 
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HEX 


09 
91 
G2 


NULL 
SOH 
STX 
ETX 
ET 
ENQ 
ACK 
BEL 
BS 


HT 
LF 
VT 
FF 


CR 
SO 
SI 
DLE 
DC 1 
DC2 
DC3 
DC4 
NAK 
SYN 
ETB 
CAN 
EM 
SUB 
ESCAPE 
FS 
GS 
RS 
US 


CTRL-@ 
CTRL-A 
CTRL—-B 
CTRL-C 
CTRL-D 
CTRL-E 
CTRL-F 
CTRL-G 


CHRS (8) 


CTRL-I 
CTRL-J 
CTRL-K 
CTRL-L 
CTRL-M 
CTRL-N 
CTRL-O 
CTRL-P 
CTRL-Q 
CTRL-R 
CTRL-S 
CTRL-T 


CHRS$(21) 


CTRL-V 
CTRL-W 
CTRL~-X 
CTRL-Y 
CTRL-Z 
ESC 


CHRS$ (28) 
CTRL-SHIFT—-M 
CTRL-SHIFT-N 
CHRS$(31) 


CHAR WHAT TO TYPE 


or 


RETURN 


APPENDIX B 
BUS INPUT/OUTPUT SEQUENCES 


This appendix illustrates the input/output sequences for the GPIB with 
an example of each command. The DIO mnemonics are messages defined 

by the IEEE-488 standard. Here are the meanings of the messages that 
the Apple uses. For more information see the IEEE-488 standard. 


DIO Command Hex Binary Translation 
DCL 14 X991G199 Device CLear 
GET 68 X9GG1900 Group Execute Trigger 
GTL Gl X9GGGGG1 Go To Local 
LLO ll X9G190G1 Local LockOut 
MLA X@1 Dev.Adr. My (the Apple) Listen Address 
MTA X19 Dev.Adr. My (the Apple) Talk Address 
PPC @5 X999GG191 Parallel Poll Configure 
PPD 79 X1119009 Parallel Poll Disable 
PPE 69 X11QSPPP Parallel Poll Enable 
PPU 15 X9G19191 Parallel Poll Unconfigure 
SDC G4 X9GGG190 Select Device Clear : 
SPD 19 X9G114691 Serial Poll Disable 
SPE 18 X9G11009 Serial Poll Enable 
UNL 3F XG111111 UNListen 
UNT 5F X1911111 UNTalk 


MLA and TLA are formed using the 5 lowest bits of the Apple’s device 


address. Three mnemonics, LSTN, TALK, and XFER, are used which are 
not derived from the IEEE-488 standard. 


LSTN — The controller is waiting to carry out a transaction 
with a listener. The Apple will not send new data (signalled 
by pulling the DAV line low) until all listeners are ready to 
accept data (NRFD = 1) and one listener has acknowledged the 
fact that there is no data currently valid (by pulling the NDAC 
line low). 


TALK -— The controller is waiting to carry out a transaction 
with a talker. The Apple will not accept data (by setting 
NDAC to 1) until the data is valid (DAV = Q) and one listener 
has recognized that there is valid data on the bus (by 
pulling NRFD low). 


XFER -~ The addressed talker and listeners will carry out a 
handshake sequence to transfer data on the bus. The Apple 


does not participate. 


In the commands on the next page, the character sequence <CR> 
represents pressing the key labelled RETURN (ASCII 13). It is not to 
be interpreted character by character. As before, ZS is a variable 
that has been set to contain the value <CTRL-Z> (ASCII 26). 
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COMMAND DIO DIO MGMNT HNDSHK 
MNEMONIC (HEX ) 


PRINT "WT1"3Z$3"DATA" 
or 
PRINT "WC1"3Z$3;"5"5ZS3"DATA<CR>"; 


MTA 4g ATN LSTN 
UNL 3F ATN LSTN 
primary listener 31 ATN LSTN 
D 44 LSTN 
A 41 LSTN 
iE 54 LSTN 
A 41 LSTN 
<CR> [EOS] QD EOL LSTN 
idle XX ATN 
PRINT "RDAa"3ZS$3 
INPUT C$ 
or 
PRINT "RCAa"3ZS3"5"3ZS3 
INPUT C$ primary talker 4] ATN LSTN 
secondary talker 61 ATN LSTN 
UNL 3F ATN LSTN 
MLA 29 ATN LSTN 
D 44 TALK 
A 41 TALK 
T 54 TALK 
A 4l TALK 
<CR> gD [EOL ] TALK 
idle XX ATN 
PRINT "XFA"3ZS3;"19"5Z$ primary talker 4) ATN LSTN 
UNL 3F ATN LSTN 
primary listener 31 ATN LSTN 
primary listener 39 ATN LSTN 
D 44 XFER 
A 41 XFER 
T 54 XFER 
A 41 EOL XFER 
idle XX ATN 
PRINT "TG1"53ZS UNL 3F ATN LSTN 
primary listener 31 ATN LSTN 
GET 08 ATN LSTIN 
idle XX ATN 
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PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


INPUT 


PRINT 
INPUT 


COMMAND 


"oa 


NELI3Z6 


MRA" 


"RM1"3ZS 


BF ade 


Wr At 


"LO1"3Z$ 


"OR! 3GS 


"SPA"5ZS3 


H$ 


DIO 
MNEMONIC 


DCL 
idle 


UNL 


primary listener 
SDC 
idle 


idle 


UNL 
primary listener 
idle 


LLO 
idle 


idle 


UNL 
primary listener 
GTL 

idle 


idle 


SPE 
primary talker 
UNL 
MLA 
status byte 
SPD 

idle 


DIO 
(HEX) 


14 
XX 


31 
G4 


3F 
31 


31 
Gl 


18 
41 
3F 
29 
(49) 
19 
XX 


MGMNT 


ATN 
ATN 


ATN 


ATN 
ATN 
ATN 


ATN, REN 


ATN 
ATN, REN 
ATN, REN 


ATN 
ATN 


ATN, REN 


ATN 
ATN 


ATN 
ATN 


[SRQ] 


SRQ,ATN 
SRQ,ATN 
SRQ,ATN 
SRQ,ATN 
[SRQ] 


[SRQ],ATN 
[SRQ],ATN 


HNDSHK 


LS TN 


LSTN 


LSTN 
LSTN 


LSTN 
LSTN 


LSTN 


LSTN 
LSTN 
LSTN 


LSTN 
LSTN 
LSTN 
LSTN 
TALK 
LSTN 
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COMMAND 


INPUT "PP";I$ 


PRINT “PE1A2B" 


PRINT "PD1"sZ$ 


PRINT "PU" 


PRINT "AB" 


PRINT “LF1" 


PRINT "WT1"3Z$3"DATA" 


DIO 
MNEMONIC 


pp byte 
idle 


UNL 
primary listener 
PPC 

PPE + SPPP * 
primary listener 
PPC 

PPE + SPPP * 
idle 


UNL 
primary listener 


PPC 
PPD 


idle 


PPU 
idle 


idle 


MTA 
UNL 


primary listener 


PrP oO 


<CR> 
<LF> 
idle 


DIO 
(HEX ) 


(49) 
XX 


MGMNT 


ATN, EOI 
ATN 


ATN 
ATN 
ATN 
ATN 
ATN 
ATN 
ATN 
ATN 


ATN 
ATN 


ATN 
ATN 
ATN 


ATN 
ATN 


IFC 


ATN 
ATN 
ATN 


EOL 
ATN 


HNDSHK 


LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 


LSTN 
LSTN 


LSTN 
LSTN 


LSTN 


LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 


* SPPP refers to the Sense bit and the 3 bit assignment bits. 


The code for PPE is logically ORed with these bits. 
the section on the PE command for more details. 
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Refer to 


COMMAND 


PRINT “ES!" 
PRINT "WT1"3ZS;3"DATA!"' 


PRINT "SC1" 


PRINT "DV16" 
PRINT "WT1"3Z$;"DATA" 


PRINT "UT" 


DIO DIO 
MNEMONIC (HEX ) 
MTA 4G 

UNL 3F 
primary listener 31 
D 44 

A 41 

T 54 

A 41 

! 21 

idle XX 

idle XX 

MTA 59 

UNL 3F 
primary listener 31 
D 44 

A 41 

T 54 

A 41 

<CR> Q@D 

idle XX 

UNT 5F 

idle XX 


MGMNT 


ATN 
ATN 
ATN 


EOL 
ATN 


ATN 


ATN 
ATN 
ATN 


EOI 
ATN 


ATN 
ATN 


HNDSHK 


LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 


LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 
LSTN 


LSTN 
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APPENDIX C 
9914 REGISTERS 


You will need to use the information in this appendix only if you 
want to send information directly to the registers contained in the 
TMS 9914 chip on the IEEE-488 card. Details on the use of the 9914 
are beyond the scope of this document. Please refer to the 9914 
specification sheets if you want or need more information. 


RS2, RS1l and RS# are the register address lines on the 9914. They 
are connected to the tHree low address lines on the Apple bus. 


The N in the Apple addresses stands for eight plus the number of the 
slot into which the GPIB is inserted. For example, if the GPIB is 


installed in slot 3 then the address of the Auxiliary Command 
Register is C@B3 or C@BB. Because address bit 3 is not decoded, two 
addresses can access each of the 9914 registers. 


9914 REGISTER APPLE ADDRESS 
READ 
RS2 RSLS 
) f) 0) INT STATUS @ CONG CON8 
"y g 1 INT STATUS 1 CON1 CON9 
") 1 g ADDRESS STATUS CON2 CONA 
¢d 1 1 BUS STATUS CON3 CONB 
l ty 1) ADDRESS SWITCH 1 CON4 CONC 
l 1 ¢ CMD PASS THROUGH CON6 CONE 
1 1 1 DATA IN CON7 CONF 
WRITE 
RS2_ RSL RS 
) ¢d if) INT MASK @ COND CON8 
) g 1 INT MASK 1 CON1 CON9 
") 1 1 AUXILIARY CMD CON3 CONB 
1 Gg if) ADDRESS REG CON4 CONC 
l , 1 SERIAL POLL CON5 COND 
1 1 g PARALLEL POLL CON6 CONE 
l 1 1 DATA OUT CON7 CONF 


NOTE: The 65902 performs a read operation before each write 
operation. Since some registers on the 9914 are reset by a read, you 
must take care that the proper action is taken. Refer to a 6592 
Programming Manual and the 9914 specifications for further details. 


An example of the use of some of the registers in the 9914 can be 
found in Appendix E. 
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APPENDIX D 
PROGRAMMING AIDS 


This appendix contains a series of helpful subroutines and programs 
for learning about and using the Apple IEEE-488 Interface Card. 


PROGRAM I: CHRS FUNCTION FOR INTEGER BASIC 


Purpose: This function gives you the ability to generate those 
characters that cannot be sent by the Apple’s keyboard (see Tables 


A-3 and A-4 in Appendix A). It should be used with Integer BASIC in 
place of the CHRS$ function available to APPLESOFT. 


Setup: Place the following lines of code somewhere in your program. 

course you may change the line numbers, but don’t change anything 
else!! Line 12% POKEs the proper ASCII code right between the " 
marks in the statement CHRS="A",. 


Code: 
1190 CHS = CHR +128* (CHR<128) 


126 LCl= PEEK (224): LC2= PEEK ( 
225)-(LC1>243): POKE 79+LCl- 
256*(LC2>127)+(LC2-255%*(LC1> 
127) )*256, CHS: CHRS="A": RETURN 


Use: 1) Place the ASCII code of the desired character into CHR. 
2) GOSUB 11% (or the line number of your first line). 
3) The value returned in CHRS is the character you want! 


Errors: If line 129 is used in a long program on an Apple with more 


than 32K bytes of memory, there is a very remote chance that you will 
get a *** 532767 ERR. If this should happen, insert a REM statement 


with about 8@ characters on a higher line number to force the CHRS$ 
function down in memory. 


Source: Contributed Programs Volumes 3-5 (contains an explanation! ) 
Apple Product #A2L9914 
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PROGRAM 2: ONERR ROUTINE 


Purpose: 
from the BUS error. 


The ONERR..GOTO statement can be used to detect and recover 
Since the BUS error cannot occur during normal 


bus protocol, it indicates that an abnormal situation exists; for 
example, it may occur if the bus is not connected properly. 


CTRL-D 
CTRL-Z 


DOS COMMAND 
BUS COMMAND 


ONERR ROUTINE AT 5@@¢ 
ENABLE OUTPUT TO BUS 
ENABLE INPUT FROM BUS 
SET SCREEN TO ON 


DO A NORMAL WRITE TO LISTENER 1 
ERROR IF BUS NOT CONNECTED 
ENABLE OUTPUT TO SCREEN 

ENABLE INPUT FROM KEYBOARD 
ONERR ROUTINE 


:REM SHOULD BE 49 


:REM PRINT ERROR NUMBER 


REM USE DOS ONERR LOCATIONS 
REM TO PRINT LINE NUMBER 
:REM RESET ONERR FLAG 


A good discussion of ONERR can be found in the DOS 3.2 


Code: 
5 DIM NS(5) 
19 DS = CHRS (4) : REM 
29 ZS = CHRS (26) :REM 
25 PRINT 
39 ONERR GOTO 5@¢ : REM 
4Q PRINT D$;"PR#3" : REM 
5@ PRINT DS;"IN#3" >REM 
55 PRINT "SC1" : REM 
69 PRINT "WT1"; CHRS$ (243); ZS$;"ONERR GOTO TEST" 
61 REM 
62 REM 
70 PRINT DS;"PR#O" :REM 
86 PRINT DS;"IN#O" :REM 
99 END 
509 PRINT : PRINT :REM 
519 PRINT "’ONERR GOTO’ GOT US HERE" 
511 PRINT : PRINT "ERROR FLAG = "3 
512 PRINT PEEK (222) : PRINT 
513 PRINT "ERROR OCCURRED AT LINE "3 
514 PRINT PEEK (218) + 256 * PEEK (219) 
515 
516 
520 POKE 216,@ 
530 PRINT : PRINT 
549 INPUT “FIX BUS THEN HIT RETURN TO CONTINUE";NS 
559 GOTO 25 
Use: To test the ONERR routine: 
1) Enter the program, 
2) Make sure the bus is disconnected. 
3) Run the program. 
4) Reconnect the bus and continue. 
Note: 
Manual, Apple Product #A2L@@12. 
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PROGRAM 3: SKIP REINITIALIZE FUNCTION 


Purpose: When a PR#n and IN#n are issued with the IEEE-488 card in 
slot n, all the card’s options are initialized to their default 
values. The subroutine beginning at line 299% does a PR#3, IN#3 
without reinitializing the card. It can be adapted to any slot. 


Code: 

190 DIM AS(1@) sREM DELETE LINES 149-129 

119 DIM CS$(1@) :REM IF YOU ARE USING 

129 DIM GS(1@) :REM APPLESOFT. 

139 zs="™ :REM ZS CONTAINS CTRL~Z 

149 ps =" sREM DS CONTAINS CTRL-D 

199@ PRINT DS;"IN#3" :REM ENABLE INPUT FROM SLOT 3 
1919 PRINT DS$;"PR#3" :REM ENABLE OUTPUT TO SLOT 3 

192¢ PRINT "SCl1" :REM TURN ON THE SCREEN 

1930 PRINT "WT123"3Z$;"HIL" :REM SEND "HI" TO THE GPIB & SCREEN 
1950 INPUT "SR";GS :REM SERVICE REQUESTED? 

1969 PRINT DS;"IN#G" :REM ENABLE INPUT FROM KEYBOARD 
1979 PRINT DS;"PR#O" :REM ENABLE OUTPUT TO SCREEN ONLY 


1989 INPUT "THIS LINE DOES NOT APPEAR ON THE BUS — PRESS RETURN TO 
CONTINUE."3A$ 
1999 GOSUB 209¢ :REM RESTORE INPUTS AND OUTPUTS 
1199 PRINT "WC123"3Z$3"5"3Z$;"—DATA"; :REM SEND "—DATA" TO 
:REM GPIB AND SCREEN 


1119 PRINT "RDA";ZS$; :REM SEND COMMAND, ADRS, CTRL-Z 
112G INPUT C$ :REM AND GET INPUT STRING 
1136 PRINT D$;"IN#O" :REM ENABLE INPUT FROM KEYBOARD 
1149 PRINT DS$;"PR#O" :REM ENABLE OUTPUT TO SCREEN 
120% END 
1998 REM ---- THIS SUBROUTINE DOES A PR#3/IN#3 WITHOUT RESETTING 
1999 REM ---- THE GPIB DEFAULT VALUES. 
2000 POKE 54,6 :REM POKE ADDRESS OF CHARACTER 
2910 POKE 55,195 :REM OUTPUT SUBROUTINE. 

: REM 195 = 192 + SLOT NUMBER 
292 POKE 56,3 :REM POKE ADDRESS OF CHARACTER 
2930 POKE 57,195 :REM INPUT SUBROUTINE. 

:REM 195 = 192 + SLOT NUMBER 
2049 CALL 1992 :REM CALL DOS INITILIZATION 
2959 RETURN 


Use: 1) Type in the code. 


2) If you don’t have DOS, delete line 2049 and the D$’s. 
3) Run it. 


4) You can use lines 2999-2959 as a general subroutine. 


Errors: This code will not work with DOS 3.1. 
Notes: 1) DOS input and output locations are discussed in the 


chapter on Input and Output in the DOS 3.2 (or 3.3) Manual. 
2) Lines 1$$-12% should only be used with Integer BASIC. 
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PROGRAM 4: INPUT WITH COMMAS 


Purpose: APPLESOFT interprets a comma in a data string as the end of 


input. Use this routine to input data from a device that sends 
commas. Input terminates when a CR is read. (Note that you can 
easily modify it to terminate on EOS as well.) 


Setup: Type in the lines of code 
Code: 


5 REM CAN ONLY BE USED IN APPLESOFT 
6 REM INPUT STRING IS STORED IN BS 
7 REM INPUT IS TERMINATED WITH CR 


25 as =" :; Bogs :REM STRINGS INITIALLY EMPTY 
39 GET AS :REM READ A CHARACTER AND 

49 PRINT AS; :REM ECHO IT. SEE NOTE. 

5@ IF ASC (A$) = 13 THEN RETURN:REM RETURN ON CR 

69 BS = BS + AS :REM ADD CHARACTER TO STRING 
79 GOTO 39 


Use: 1) Call with GOSUB 25 (or whatever you call that line) 
2) Input string will be returned in BS 


Notes: 1) The firmware expects strings to be read from the bus 
using the INPUT statement. Since the INPUT statement 
echoes characters to the screen, a GET statement must be 
followed by a PRINT statement to simulate this echo. In 
this way you can fool the firmware into thinking that 
normal input is being done. 


Examples: This routine is used in the second sample program in 
Appendix G. Refer to that example to see how it can be used. 
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APPENDIX E 
FAST TRANSFER ROUTINES 


Purpose: These routines are an example of how one can do fast block 
transfers over the GPIB. These routines communicate directly with 
the 9914, as opposed to normal GPIB transfers, which send a string to 
DOS, which uses the Apple Monitor Input or Output Registers to 
transfer the string character by character to the IEEE-488 card, 
which finally sends it to the 9914. These routines are also an 
example of how a machine language subroutine can be used to implement 
one of the GPIB instructions. This will be useful if you want to use 
the GPIB with the Pascal System. See Appendix F for more details on 
how to use the GPIB with Pascal. 


Background: These routines were generated using the Apple 6592 
Assembler/Editor. The code is ORG’d at $59@@ and the data at $52@@. 
You will probably need to change these locations depending on your 
application. The code assumes that your card is in slot 3, and that 
your EOS character is CR. (See the declarations of EOS and SLOT at 
$520@ and $5292.) The end of this Appendix explains how these 
routines can be run and tested. 


GPIB SUBR. DEMO 


This BASIC test program may be used to call the machine code 
subroutines. It first POKEs an RTS in place of the BRK at location 
21569 ($5441); the BRK is used for test purposes. It then calls the 
test routine at $5409, which in turn calls the other routines. 
Finally, it executes some GPIB instructions to show that the routines 
don’t interfere with normal GPIB operation. 


19 DIM S$(3@) : REM DELETE THIS LINE FOR APPLESOFT 
15 POKE 21569, 96 : REM PUT AN RTS IN PLACE OF BRK 

20 CALL 21504 : REM $549@ IS THE TEST PROGRAM 

30 zs= : REM ZS IS CTRL-Z, GPIB COMMAND 

4g pg = : REM DS IS CTRL-D, DOS COMMAND 


50 PRINT DS$;"PR#3" =: REM ENABLE OUTPUT TO CARD 
69 PRINT DS;"IN#3" : REM ENABLE INPUT FROM CARD 
65 PRINT "SCl" REM TURN SCREEN ON 


7@ PRINT "RDB";Z$;  : REM READ FROM TALKER "'B" 
75 INPUT S$ 


89 PRINT D$;"PR#@" : REM ENABLE OUTPUT TO SCREEN 

99 PRINT DS$;"IN#@" =: REM ENABLE INPUT FROM KEYBOARD 
199 PRINT "S$ = "3;S$ : REM ECHO INPUT STRING 

116 PRINT DS$;"PR#3" : REM ENABLE OUTPUT TO CARD 

129 PRINT DS$;"IN#3" : REM ENABLE INPUT FROM CARD 


125 PRINT "SCl1" : REM TURN SCREEN. ON 
139 PRINT "WT1";3ZS;"FIRMWARE" : REM SEND "FIRMWARE" TO "1" 
149 PRINT DS;"PR#@" : REM ENABLE OUTPUT TO SCREEN 


15@ PRINT DS;"IN#O" : REM ENABLE INPUT FROM KEYBOARD 
20% END 
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SUBROUTINES 


All of the following routines have arbitrary starting addresses. 


Relocate them according to your system configuration. 


relocate the seven bytes of storage. 
data and device lists is up to you. 


GENERAL CONTROL VALUES 


The general control values assume that the Apple is device #@. 


EQU 


EQU 
EQU 
EQU 
EQU 
EQU 


EQU 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


EQU 
EQU 


SCO8O 


GPIB+¢@ 
GPIB+@ 
$20 
$10 
$08 


GPIB+1 


GPIB+3 
$89 
$0g 
$83 
$63 
$89 
$8A 
$8F 
SOF 
$02 
$08 
$B 
$C 
SOD 


GPIB+/7 
GPIB+/ 


; GPIB COMMANDS 


CO80: 19 GPIB 
0000: 20 ; 
C080: 21 INTO 
CO8@: 22 INTMG 
0020: 23 BIM 
0619: 24 BOM 
0008: 25 EOIMK 
0006: 26 ; 
CG81: 27 INTM1 
000: 28 ; 
C083: 29 AUXCMD 
6080: 30 RESET 
O00G: 31 RSTCLR 
0083: 32 HDFA 
0003: 33 HDACLR 
0089: 34 LON 
QO8A: 35 TON 
GO8F: 36 SIC 
GOOF: 37 SICLR 
Q0G2: 38 RHDF 
6008: 39 FEOL 
GOOB: 40 GTS 
OQGC: 41 TCA 
QOGD: 42 TCS 
G000: 43; 
CQ87: 44 DIN 
C087: 45 DOUT 
0000: 46 ; 
GOGO: 47 

0000: 48 ; 
0020: 49 MLA 
0040: 50 MTA 
OO3F: 51 UNL 


EQU 
EQU 
EQU 
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$26 
$40 
$3F 


You must also 


The location of the buffers for 


;SET BASE ADDRESS OF ROM 
OFFSET FOR SLOT 3 ASSUMED 

s INTERRUPT REG. @ 

sINTRP MASK REG @ 

sBYTE IN MASK 

sBYTE OUT MASK 

sEOL MASK 


; INTRP MASK REG Il 


; AUXILIARY COMMAND REGISTER 
sSOFTWARE CHIP RESET 

sSTOP SOFTWARE RESET 
sHOLDOFF ON ALL DATA 

sCLEAR HOLDOFF ON ALL 
sLISTEN ONLY 

sTALK ONLY 

sSEND INTERFACE CLEAR 
sCLEAR SIC 

sRELEASE RFD HOLDOFF 

sSEND EOI WITH NEXT BYTE 
:GO TO STANDBY 

sTAKE CONTROL ASYNCHRONOUSLY 
sTAKE CONTROL SYNCHRONOUSLY 


;sDATA IN REGISTER 
;DATA OUT REGISTER 


sMY LISTEN ADDRESS 
sMY TALK ADDRESS 
sUNIVERSAL UNLISTEN 


INITIALIZE 9914 


All of the routines make common assumptions about the state of the 
9914 chip upon entry, and all will leave the 9914 in this same state 
upon exit. The INIT routine sets the 9914 to this desired state. 
These assumptions are: 


- BO set 

- All interrupts masked off 

- TON (talk only) on 

- Not listener active (LA) 

- No holdoffs enabled or active 

- No 6592 registers destroyed 

- Status obtained by polling the 9914 


SUBROUTINES CALLED: WAIT 


5906: 101 ORG $5000 

50060: 102 ; 

5090: 08 193 INIT: PHP sSAVE REGISTERS 
5001:48 104 PHA 

5002: 98 195 TYA 

5003:48 196 PHA 

5004: 8A 107 TXA 

5005:48 148 PHA 

5096:AC 92 52 1969 LDY SLOT sGPIB SLOT INDICATOR 
5999:A9 80 119 LDA #RESET sRESET 9914 

509B:99 83 c@ 111 STA AUXCMD,Y 

50GE:A9 OP 112 LDA #RSTCLR ;TURN OFF RESET 
5010:99 86 Cd 113 STA INTMG,Y  3;CLEAR INTERRUPTS 
5013:99 81 CH 114 STA INTM1,Y  ;CLEAR INTERRUPTS 
5016:99 83 cM 115 STA AUXCMD,Y 

5919:A9 8F 116 LDA #SIC SEND INTERFACE CLEAR 
501B:99 83 CM 117 STA AUXCMD,Y ;AND TAKE CONTROL 
5Q01E:A2 64 118 LDX #4 35.12 MSEC DELAY 
5020:A0 09 119 LDY #¢ INITIALIZE INNER LOOP 
5622: 88 126 INIT1: DEY 5 USEC INNER LOOP 
5023:D@ FD 121 BNE INIT1 1288 USEC TOTAL 
5025:CA 122 DEX 

59026:D@ FA 123 BNE INITI 

5028:AC @2 52 124 LDY SLOT 

502B:A9 GF 125 LDA #SICLR sCLEAR INTERFACE CLR 
592D:99 83 CO 126 STA AUXCMD,Y 

5030:A9 8A 127 LDA #TON sSET TALK ONLY MODE 
5932:99 83 CP 128 STA AUXCMD,Y 

5035220 32 51 129 JSR WAIT sWAIT FOR BYTE OUT 
5938: 130 ; TO INDICATE CONTROL TAKEN 
5038: 68 131 PLA sRESTORE REGISTERS 
5939:AA 132 TAX 

593A: 68 133 PLA 

503B:A8 134 TAY 

503C:68 135 PLA 

593D: 28 136 PLP 

503E: 69 137 RTS sRETURN TO CALLING POINT 
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SEND ROUTINE 


The send routine can be used in place of the WT or WC command. 


It 


terminates either when COUNT bytes have been sent or when EOS is 


sent. 


INPUTS: 


OUTPUTS: 


REGISTERS DESTROYED: 


503F:98 
5046:48 
5041:98 
5942:48 
5943: 8A 
5044:48 
5045:AC 
5048:A9 
5@4A: 99 
504D: 20 
5050:A9 
5052:99 
5955:A2 
5657:BD 
595A:C9 
595C:30 
5Q5E:C9 
5960:1¢ 
5962:20 
5965:BD 
5068: 99 
506B:E8 
506C:10 
506E: 

5Q6E:A9 
5070:99 
5073:20 
5076: 

5076:A2 
5078:EC 
507B:FO 
507D:CE 
5080:F 
5082: 

5982:BD 
5@85:CD 
5088:FO 
5@8A:99 
5Q08D:2¢ 
5990:E8 
5091:D¢ 


38 


EA 


52 


Cé 
51 


cp 
52 


51 
52 


CO 


oy 
51 
52 
52 
52 
52 


ot) 
51 


ABUF 
DBUF 


It asserts EOI in both cases. 


= Pointer to the listener list 


= Pointer to the data buffer 
COUNT = Number of bytes to send; @ causes no data. 


None to software 
SUBROUTINES CALLED: 


157 SEND: 


158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
179 
171 
172 
173 
174 
175 
176 
177 
178 
179 
18@ 
181 
182 
183 
184 
185 
186 
187 
188 
189 
196 
191 
192 
193 
194 
195 
196 
197 


SENDI1: 


’ 
SEND2: 


SEND3: 


SEND4: 


WAIT 
None 
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SLOT 
#MTA 
DOUT, Y 
WAIT 
#UNL 
DOUT, Y 
#0 
ABUF ,X 
#520 
SEND2 
#S3F 
SEND2 
WALT 
ABUF , X 
DOUT,Y 


SEND1 


#GTS 
AUXCMD, Y 
WAIT 


#0 

COUNT 
SEND6 
COUNT 
SEND5 


DBUF ,X 
EOS 
SEND5 
DOUT, Y 
WAIT 


SEND3 


EOS = The terminating character 


SAVE REGISTERS 


;GPIB SLOT INDICATOR 
3;MY TALK ADDRESS 


;sWAIT FOR BYTE OUT 
;sUNIVERSAL UNLISTEN 


;BUFFER INDEX 

;GET LISTENER ADDRESS 
;LOWER LIMIT OF RANGE 
;UPPER LIMIT 


sWAIT FOR UNL BYTE OUT 
3GET LISTENER AGAIN 


sOUTPUT IT TO GPIB 


sALWAYS TAKEN 


(MAX OF 31 LISTENERS! ) 
:GO TO STANDBY 


;WAIT FOR ATN TO BE 
DE-ASSERTED 

sINITIALIZE DATA BUF INDEX 

31S INITIAL COUNT =? 

sYES--GO QUIT 


3;1F COUNT FINISHED GO SEND EOI 
WITH LAST CHARACTER 

;GET DATA BYTE 

31S IT LAST CHARACTER? 


3; YES--GO HANDLE IT 


sOUTPUT DATA TO GPIB 


;WAIT FOR DATA BYTE OUT 


sALWAYS TAKEN 


5093:A9 
5095:99 
5098:BD 
509B:99 
509F:E8 
509F:CE 
50A2: 29 
5QA5:A9 
50A7:99 
50AA: 29 
5@AD: 68 
5@AE:AA 
5OAF : 68 
50BO:A8 
50B1:68 
50B2:28 
50B3: 60 


08 
83 
05 
87 


pl 
32 
OC 
83 
32 


cé 
52 


CO 


52 
51 


CO 
51 


198 SENDS: 
199 
200 
261 
292 
293 
204 
205 SENN6: 
296 
207 
208 
2069 
2106 
211 
212 
213 
214 


RECEIVE ROUTINE 


The receive routine can be used in place of the RD or RC command. 
terminates either when COUNT bytes have been read or when EOS is read 
or when EOI goes high. 


INPUTS: 


OUTPUTS: 


REGISTERS DESTROYED: 


50B4:68 
50B5:48 
50B6:98 
50B7:48 
50B8:8A 
590B9:48 
5@BA:AC 
5@BD:A2 
5@BF:AD 
59C2:99 
50C5:2¢ 
50c8:A9 
50CA: 99 
50CD: 2G 
50D¢:A9 
5@D2:99 
50D5:A9 
50D7:99 
5@DA:A9 
5@DC: 99 
5@DF:A9 
50E1:99 
5GE4:20 


52 
52 
CG 
51 


CG 
51 


ot) 
cg 
Cc 


CO 
51 


ABUF 
DBUF 


#FEOI 
AUXCMD, Y 
DBUF , X 
DOUT,Y 


COUNT 
WALT 
#TCA 
AUXCMD, Y 
WAIT 


;FORCE EOI W/ EOS 


;GET BYTE AGAIN 
sOUTPUT TO GPIB 


;FOR CONSISTENCY 
;WAIT FOR LAST BYTE OUT 
3 TAKE CONTROL 


sWAIT FOR CONTROL 
;RESTORE REGISTERS 


;RETURN TO CALL POINT 


Pointer to the talker list 
Pointer to the data buffer 


It 


COUNT = Number of bytes to receive; @ receives no data 
EOS = The terminating character 
Data buffer is filled 
SUBROUTINES CALLED: 


235 RECV: 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 


SLOT 

#6 

ABUF 
DOUT,Y 
WAIT 
#UNL 
DOUT,Y 
WAIT 
#MLA 
DOUT, Y 
#HDFA 
AUXCMD, Y 
#LON 
AUXCMD, Y 
#GTS 
AUXCMD, Y 
WAIT 


sSAVE REGISTERS 


sGPIB SLOT IDENTIFIER 


sGET TALKER DEVICE NO. 
sOUTPUT IT TO GPIB 
sWAIT FOR BYTE OUT 
sUNIVERSAL UNLISTEN 
sOUTPUT IT TO GPIB 
sWAIT FOR BYTE OUT 

sMY LISTEN ADDRESS 
sOUTPUT IT TO GPIB 
sENABLE HOLDOFF ON ALL 


sLISTEN ONLY-CLEAR TON 
sGO TO STANDBY 


sWAIT FOR MLA BYTE OUT 
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5GE7:B9 86 C@ 258 RECV1: LDA _ INT@,Y -;sWAIT FOR BYTE IN 


59EA:29 28 259 AND #EOIMK+BIM ;TEST FOR EOI OR BI 
50EC:FO F9 260 BEQ RECV1 | 

5@EE:29 68 261 AND #EOIMK sIS IT EOI? 

50F6:DG 18 262 BNE RECV2 ;YES 

5OF2:B9 87 CO 263 LDA DIN,Y 3;GET DATA BYTE FROM GPIB 
56F5:9D 65 52 264 STA DBUF,X sSTORE IT IN BUFFER 
5QF8:CD 60 52 265 CMP EOS s1S IT THE EOS CHAR? 
5OFB:FQ@ 14 266 BEQ RECV3 ;YES 

50FD:E8 267 INX 

5QFE:A9 62 268 LDA #RHDF RELEASE HOLDOFF 
5190:99 83 CO 269 STA AUXCMD,Y 

5103:CE @1 52 270 DEC COUNT 

5166:FO OC 271 BEQ RECV4 sGO IF COUNT = 
5198:D6 DD 272 BNE RECV1 sALWAYS TAKEN--GO FOR MORE 
519A:B9 87 C® 273 RECV2: LDA DIN,Y sGET LAST BYTE 
510D:9D @5 52 274 STA DBUF,X 

5116:E8 275 INX 

5111:CE 61 52 276 RECV3: DEC COUNT 

5114:A9 @D 277 RECV4: LDA #TCS sTAKE CONTROL SYNC 
5116:99 83 CH 278 STA AUXCMD,Y 

5119:20 32 51 279 JSR WAIT sWAIT FOR CONTROL 
511C:A9 @2 280 LDA #RHDF ;RELEASE HOLDOFF 
511E:99 83 CO 281 STA AUXCMD,Y 

5121:A9 8A 282 LDA #TON ;SET TALK ONLY, CLR LON 
5123:99 83 CO 283 STA AUXCMD,Y 

5126:A9 @3 284 LDA #HDACLR ;CLEAR HOLDOFF MODE 
5128:99 83 CO 285 STA AUXCMD,Y 

512B:68 286 PLA sRESTORE REGISTERS 
512C:AA 287 TAX 

512D: 68 288 PLA 

512E:A8 289 TAY 

512F:68 2990 PLA 

5130:28 291 PLP 

5131: 60 292 RTS sRETURN TO CALL POINT 


WAIT ROUTINE 


The wait routine reads the INT@ register until the Byte Out or Byte 
In bit is set. 


INPUTS: Register Y contains the slot number 
OUTPUTS: None 
PROCEDURES CALLED: None 


REGISTERS DESTROYED: None 


5132:B9 89 CH 316 WAIT: LDA _ INT@,Y sGET BYTE OUT FLAG 


5135:29 10 311 AND #BOM 
5137:FO F9 312 BEQ WAIT ;LOOP UNTIL SET 
5139: 69 313 RTS 
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DATA BUFFERS 


The following data buffers work with the test routine given. You may 
have to change them to suit your purposes. Notice that’ the default 
value of EOS is CR, the default number of bytes counted is 255, and 
the default slot is 3. ABUF, the list of listeners or talkers is 
only large enough to contain one listener or talker; this may be set 
according to your needs. This list may actually end with any 
non-listener or non-talker depending on which routine is using it. 


5206: 325 ORG $5200 

5200: 326 ; 

5200: 0D 327 EOS DFB S@D 3;EOS CHARACTER--DEFAULT IS CR 
5201:FF 328 COUNT DFB SFF ;BYTE COUNT FOR DATA BUFFER 
5202: 329 ; --DEFAULT IS 255 

5202: 30 33@ SLOT DFB $30 ;OFFSET TO SLOT 3 ADDRESSES 
5203: 331 ; --DEFAULT IS SLOT #3 
5203: 332 ABUF DS 2 ;sDEVICE LIST 

5205: 333-3 -—-MUST END WITH SFF BYTE 
5205: 334 DBUF DS 256 sDATA BUFFER 
SUBROUTINE TEST 


This routine tests the subroutines that have already been given. It 
is called by the GPIB SUBR DEMO given at the beginning of this 
section. It sends data to listener $21 (ASCII "!") and receives data 
from talker $41 (ASCII "A"). The data buffer (DBUF) is filled with 
the numbers 1 through 5 followed by a CR. This data is first sent 
with COUNT as initialized (255) so that the CR terminates output. 
Then it is sent with a COUNT of 5; thus the CR doesn’t get sent. The 
BRK in line 376 was replaced by an RTS instruction, thus the RECV 
routine is only called once, and the loop is never executed. 


Notes: The code assumes that <EOS> is set to <CR>. If you have 
changed your EOS, the first call to SEND will send 255 bytes. 


5400: 347 ORG $5469 

5406: 348 ; 

5400:20 06 50 349 JSR INIT sSET UP GPIB INITIALLY 
5403:EA 356 NOP 

5404:A9 21 351 LDA #821 sLISTENER ADDRESS 
5406:8D 03 52 352 STA ABUF 

5409:A9 FF 353 LDA #SFF sLIST END 

549B:8D 04 52 354 STA ABUF+1 

54QE:A9 Ql 355 LDA #1 

5410:8D @5 52 356 STA DBUF sDATA TO BE SENT 
5413:A9 @2 357 LDA #2 

5415:8D 66 52 358 STA DBUF+1 

5418:A9 @3 359 LDA #3 

541A:8D @7 52 366 STA DBUF+2 

541D:A9 @4 361 LDA #4 

541F:8D @8 52 362 STA DBUF+3 

5422:A9 @5 363 LDA #5 

5424:8D 99 52 364 STA DBUF+4 
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5427:A9 QD 365 LDA #S@D 36 BYTES OF DATA INCL CR 
5429:8D GA 52 366 STA DBUF+5 
542C:20 3F 50 367 JSR SEND 
542F:EA 368 NOP 
543G:A9 G5 369 LDA #5 35 BYTES OF DATA, NO CR 
5432:8D G1 52 37¢ STA COUNT 
5435:2@0 3F 50 371 JSR SEND 
5438:EA 372 NOP 
5439:A9 41 373 LDA #841 sTALKER ADDRESS 
543B:8D @3 52 374 STA ABUF 
543E:29 B4 50 375 LOOP: JSR RECV 
5441: 49 376 BRK 
5442:4C 3E 54 377 JMP LOOP 
5445: 378 ; 
5445: 379 ;END 
SYMBOL TABLE 
5203 ABUF C@83 AUXCMD 20 BIM 10 BOM 
5201 COUNT 5205 DBUF CQ87 DIN CG87 DOUT 
08 EOIMK 5200 EOS @8 FEOI C080 GPIB 
OB GTS @3 HDACLR 83 HDFA 5000 INIT 
5@22 INIT1 CQ86 INT? CG8¢ INTMG C@81 INTM1 
89 LON 543E LOOP 26 MLA 4Q MTA 
51@A RECV2 5@B4 RECV 5@E7 RECV1 5111 RECV3 
5114 RECV4 86 RESET @2 RHDF @@ RSTCLR 
5657 SEND1 50@6E SEND2 503F SEND 597D SEND3 
2508D SEND4 5093 SENDS 5@A5 SEND6 @F SICLR 
8F SIC 5262 SLOT 6C TCA @D TCS 
8A TON 3F UNL 5132 WAIT 
DATA RATES 


When the GPIB does a WRITE operation, it transfers the data at a rate 


of 1.5 kilobytes per second. 


This does not include the roughly 


3.5 millisecond interval during which processing of the instruction 


takes place. 


of about 1 kilobyte per second. 


For a READ operation, the GPIB transfers data at a rate 


The performance of the L[EEE-488 bus can be improved with the 
preceding routines. These routines, as listed, send and receive data 
at a rate of 29 kilobytes per second. Even this is not optimal. If 
the above routines are streamlined to transfer data by count only, 
they will send data at a rate of 5% kilobytes per second. 
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RUNNING AND TESTING 


Our version of the APPLESOFT program used to run these subroutines 
was called GPIB SUBR DEMO. The assembly language routine source code 


was saved in the file GPIB SUBR. The 6592 Assembler places the 
assembled code into the files: 


GPIB SUBR.OBJG 
GPIB SUBR.OBJ1 
GPIB SUBR.OBJ2 


(routines ) 
(data) 
(test code) 


The routines may be tested with the following sequence of commands: 


] BLOAD GPIB SUBR.OBJG 
] BLOAD GPIB SUBR.OBJ1 
] BLOAD GPIB SUBR.OBJ2 
] RUN GPIB SUBR DEMO 


We recommend that you use a ZT 488 GPIB Analyzer to verify 
correct operation of the routines. The sequence of bus signals 


should be: 
DIO MGMNT DIO MGMNT DIO MGMNT DIO MGMNT DIO MGMNT 
4G ATN 4G ATN 4l ATN 42 ATN 4g ATN 
3F ATN 3F ATN 3F ATN 3F ATN 3F ATN 
21 ATN 21 ATN 29 ATN 29 ATN 31 ATN 
1 1 INPUT INPUT 46 
2 2 any any 49 
3 3 sequence sequence 52 
4 4 terminated terminated 4D 
5 5 EOL with with 57 
@D EOI QD or EOL OD or EOI 41 
52 
45 

13) EOL 
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APPENDIX F 
PROGRAMMING IN PASCAL 


Because the GPIB firmware is designed to interact with BASIC, the 
Monitor and DOS, it will not behave properly if commands are sent to 
the GPIB using the Pascal WRITE and WRITELN commands. This does not, 


however, mean than the Apple GPIB cannot be used with the Pascal 
System. 


If you are familiar with 65@2 Assembly Language, and with the Apple 
Pascal Operating System, it is possible for you to implement most or 
all of the GPIB commands for use with the Pascal System. 


WHAT YOU MUST DO 


What you must do is write a Pascal procedure for each of the GPIB 
instructions that you want to implement. Some of these procedures, 
for example SC, can be written entirely in Pascal. Others, however, 
must be at least partially written in 6592 assembly code. In the 
6592 code you send commands directly to the 9914 chip. 


Before you can even attempt to write 6502 routines, you must know 
what commands are required by the 9914. Obtain the TMS 9914 (made by 
Texas Instruments) specifications to find out what values must be 
sent to which of the registers in the 9914 to implement the GPIB 
instructions that you will need. 


Look in Appendix C to determine the Apple addresses of the registers 
on the 9914. These are the addresses with which your assembly 
language routines must communicate. The routines that you write must 
communicate with the 9914 registers in the same way as the Send, 
Receive and Initialize routines given in Appendix E. (See the use of 
locations INT@, INTM@, INIM1, DIN and DOUT.) In fact, you can even 
use slightly modified versions of these three routines as the start 
of your Pascal GPIB package. 


Now write a 6592 procedure that will carry out the function that you 


want to implement. All that you must do is link this procedure into 
the Pascal system. 


Information on the Apple Pascal’s 6592 Assembler directives may be 
found in the chapter on the 6592 Assembler in the Apple Pascal 
Operating System Reference Manual (Apple Product #A2L9928). This 


chapter explains how a procedure must be structured to be linked into 
the Pascal System. 


PROGRAMMING IN PASCAL 65 


The chapter on the Linker in the same manual explains the actual 
process of linking a procedure into the Pascal System. Finally, 
the Apple Pascal Language Reference Manual (Apple Product #A2L9@27) 
tells how EXTERNAL procedures (all assembly language procedures are 
external to the host program) are declared and called from within a 
Pascal host program. 


Since your assembly language routines will be communicating 


with addresses that are external to the Apple, it is very 
advisable that you use a logic analyzer such as the ZT488 GPIB 
ANALYZER to monitor the signals on the bus. This may be the 
only way that you can verify correct bus operation. 
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APPENDIX G 
SAMPLE PROGRAMS 


This appendix contains two sample programs for the IEEE-488 card. 
You won’t be able to use these programs unless you happen to have an 
HP 3438A Multimeter or an HP 3586C Selective Level Meter. 


Nevertheless, they serve as excellent examples of the types of 
programs that can be written for the GPIB. 


READ ROUTINE FOR HP 3438A 


The HP3438A Multimeter has a device number of 3. Its listener 
address is "#" and its talk address is "C". The following program 
assumes that the IEEE-488 card is in slot 3. The data sent by the 
3438A takes the form SD.DDDESD,F<CR><LF> for which 


is the sign, either "+" or "=" 

is a decimal digit from "9" to "9" 

is an "E" indicating the exponent 

» is a delimiter between the value and the function code 
F is the function code, a digit between "1" and "5" 
<CR><LF> is carriage return followed by line feed 


moM 


19 DIN S$(39): REM ------- DELETE FOR APPLESOFT 
20 DIM C$(3@): REM <------ DELETE FOR APPLESOFT 
39 ZS = "": REM CTL=-Z 
49 DS = '"": REM CTL-D 


5@ PRINT DS;"PR#3" 
69 PRINT DS;"IN#3" 


79 PRINT "SC1": REM <----- TURN THE SCREEN ON 

8% PRINT "TG#"5Z$:3 REM --~- TRIGGER A READING 

99 PRINT "LF1": REM ---- 3438A SENDS A <CR><LFD> 

197 PRINT "RDC"3Z$;: REM -— READ FROM TALKER "C" 

116 INPUT SS$,CS: REM ---- SS GETS CHARACTERS BEFORE 

126 RIM wenn n enn nena === THE "," SENT BY THE 3438A 

130) REM oo werner een en nn == C$ GETS CHARACTERS AFTER THE "," 


140 PRINT DS;"PR#O": REM —- SEND OUTPUT TO SCREEN 

150 PRINT DS;"IN#O": REM —- GET INPUT FROM KEYBOARD 

169 PRINT "READING = "Ss; 

176 REM ------------------- NEXT LINE COMPUTES VALUE OF FUNCTION 
189 REM ------------------- CODE RETURNED BY THE 3438A 
199 ON ASC ( LEFTS (C$,1)) - 48 GOTO 206,216,220, 234, 24¢ 
209 PRINT " DCV'": GOTO 25¢ 

219 PRINT " ACV": GOTO 25¢ 

220 PRINT " DCI": GOTO 25¢ 

2 PRINT " ACI": GOTO 25¢ 

24 PRINT " OHMS": GOTO 259 

25% INPUT "WOULD YOU LIKE ANOTHER READING(Y OR N) ?"3AS$ 
200 IF A$ = "Y" THEN GOTO 5¢ 

270 END 


SAMPLE PROGRAMS 


GENERAL PURPOSE HP 3586C ROUTINE 


1g REM ROUTINE FOR HP3586C SELECTIVE LEVEL METER 
2% REM METER IS DEVICE 16 

39 REM LISTEN ADDRESS IS ASCII 39 = "9" 

49 REM TALK ADDRESS IS ASCII 5@ = "Pp" 


50 REM ASSUMES CARD IN SLOT #3 
69 D$ = "": REM CONTROL-D 
70 Z$ = "": REM  CONTROL~Z 


89 DIM CS$(10@): REM DELETE FOR APPLESOFT 
9% GOSUB 59%: REM INITIALIZE CARD FOR I/O 
199 GOSUB 66%: REM INITIALIZE APPLE FOR 1/0 


116 HOME 

126 VTAB 5: HTAB 18: PRINT "MENU": PRINT : PRINT 
130 HTAB 8: PRINT "1 : PRINT TO THE DEVICE" 

146 HTAB 8: PRINT "2 : LISTEN TO DEVICE" 

150 HTAB 8: PRINT "3 : CLEAR DEVICE" 

16% HTAB 8: PRINT "4 : REMOTE ENABLE DEVICE" 

176 HTAB 8: PRINT "5 : LOCAL LOCKOUT DEVICE" 

18¢ HTAB 8: PRINT "6 : SET DEVICE TO LOCAL MODE" 
199 HTAB 8: PRINT "7 : ABORT SEQUENCE" 

290 HTAB 8: PRINT "8 : SEND LITERAL STRING" 

219 HTAB 8: PRINT "9 : QUIT": PRINT : PRINT 

220 HTAB 8: PRINT “WHAT IS YOUR COMMAND?" 


239 GET A 

249 ON A GOTO 309,350 

259 GOSUB 699 

260 ON A - 2 GOTO 489,499, 500,514,52¢ 

279 GOSUB 6690 

280 ON A- 7 GOTO 539,580 

299 GOTO 11¢: REM NO SUCH COMMAND 

39@0 PRINT "ENTER COMMAND AND DATA": REM PRINT TO THE DEVICE 
31¢ INPUT CS 

320 GOSUB 69%: REM INITIALIZE CARD FOR I/0 

330 PRINT "WT@";Z$;CS: REM SEND COMMAND TO METER 

340 GOTO 19%: REM GET NEXT COMMAND 

359 PRINT “INCOMING DATA IS..." 

360 GOSUB 696: REM INITIALIZE CARD FOR I/O 

376 PRINT "TGO";Z$: REM DEVICE MUST BE TRIGGERED REFORE READING 
386 PRINT "RDP";Z2S;: REM READ FROM DEVICF. 


399 cS = '": REM SET CS TO EMPTY 
40@ GET AS: PRINT AS;: REM GET CHARACTER. 
419 REM --- SEE NOTE FOR REINITIALIZE FUNCTION. 


426 IF ASC (AS) = 13 THEN 449: REM REPEAT UNTIL <CR> 
430 CS = CS + AS: GOTO 49%: REM SAVE CHARACTERS IN CS 
44% GOSUB 660: REM INITIALIZE APPLE FOR I/0 
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45 PRINT C$: REM PRINT INPUT STRING 

46 PRINT "HIT ANY KEY TO CONTINUE..." 

47@ GET AS: GOTO 11%: REM GET NEW COMMAND 

48% PRINT "CA": GOTO 10@: REM CLEAR ALL REMOTE DEVICES 

49% PRINT "RA": GOTO 19@: REM ENABLE DEVICES FOR REMOTE OPERATION 
50¢ PRINT "LL": GOTO 19%: REM LOCAL LOCKOUT DEVICE 

51@ PRINT "LA": GOTO 199: REM LOCKOUT DEVICE’S FRONT PANEL 
526 PRINT "AB": GOTO 16%: REM SET ALL DEVICES TO LOCAL NODE 
539 PRINT "ENTER THE LINE TO BE TRANSMITTED:" 

54 INPUT C$: REM READ LINE 

55@ GOSUB 699: REM INITIALIZE CARD FOR I/O 

560 PRINT C$: REM TRANSMIT LINE 

57¢ GOTO 199 

580 END 

599 PRINT D$;"PR#3": REM SEND OUTPUT TO IEEE-488 CARD 

609 PRINT D$;"IN#3": REM GET INPUT FROM IEEE-488 CARD 

619 PRINT "SC1": REM SET THE SCREEN TO ON 

620 PRINT "RA": REM ENABLE ALL DEVICES FOR REMOTE OPERATION 
630 PRINT "DV1": REM SET THE APPLE TO DEVICE 1 

640 PRINT "LF1': REM SEND AND RECEIVE <LF> AFTER <CR> 

65% RETURN 

669 PRINT D$;"PR#O": REM SEND OUTPUT TO THE SCREEN 

679 PRINT DS$;"IN#O$": REM GET INPUT FROM THE KEYBOARD 

687 RETURN 

699 PRINT 

700 PRINT D$;"PR#3": REM SEND OUTPUT TO IEEE-488 CARD 

71@ PRINT N$;"IN#3": REM GET INPUT FROM IEEE-488 CARD 

720 REM -AT THIS POINT ALL DEFAULT COMMANDS MUST RE RESET 
73@ REM -FOR EXAMPLE: LF1,SC1,DV1,ETC 

74 RETURN 


Notes: 1) Lines 419-459 contain the routine Input With Commas. 
Refer to Appendix PD for a more complete explanation of 
this code. 
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APPENDIX H 
SCHEMATIC DIAGRAM 
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Physical and Electrical Specifications 


The Apple II IEEE~-488 circuitry is mounted on a full size Apple 


Peripheral Card, measuring 2.75" by 7". The edge connector has 59 
contacts, 25 on each side of the board. The centers of the edge 
connector contacts are .1 inch apart. 


The card draws 409 milliamperes of current during normal operation; 
the maximum current it can draw is 809 milliamperes. 


All of the card’s outputs are three-state outputs that have the 
terminating resistances specified by the IEEE-488 standard. 
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GLOSSARY 


APPLESOFT: The floating-point version of BASIC that your Apple 
uses. It has the CHRS$ function that must be used to generate 
secondary: addresses. 


Asynchronous: Not synchronized. Synchronous events are generally 
clocked by the same clock pulse, asynchronous events are not. 


Buffered Input: Data that is sent to a device faster than the device 
can process it can be stored temporarily in a special input 
storage area (an input buffer) and then processed by the device 
whenever the device is ready. Input buffers are generally 
internal to devices. 


Control Function: A function that tells some device what to do. 


CTRIL: The label that appears on a key on the left side of the Apple 
II’s keyboard. It should be held down while another key is 
pressed to generate the control codes in Table A-4 of Appendix A. 


Controller: The device that controls all transfers of data and 
control bytes on the bus. The controller for the bus is the 
IEEE-488 card together with the Apple. 


Daisy Chained: Devices that are attached to a bus one after the 
other are said to be daisy chained. Devices can also be 
star connected on the bus. 


Direct Memory Access (DMA): High speed accessing of memory without 
the use of the CPU (in this case the 6592). The Apple’s 


processor can be suspended for DMA using pin 22 of a peripheral 
I/O connector slot. 


Handshake: A sequence of signals transmitted over a bus that allows 
devices to identify themselves as ready to receive data, 


transmit data, or neither. The three handshake lines for any 
IEEE-488 bus are NRFD, DAV and NDAC. 


Integer BASIC: The Apple version of BASIC that does not have the use 
of floating-point numbers. The CHRS function may be simulated 
by using Program 1 from Appendix D. 


Interface: As used in this manual, the hardware and software that 
allows two devices to communicate. 


Jumper: One or more wires (sometimes made into a plug) connected in 
one of several alternative ways. Just as you can use jumpers to 


set the memory configuration of the Apple, manufacturers often 
use jumpers to set the address to which a device responds. 
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Listener: A device that is enabled to receive data over a bus. 


Local Operation: Operation of a device using the knobs and switches 
on the device front panel, as opposed to remote operation on the 


Parallel Poll: A method of simultaneously asking many (for GPIB, up 
to eight) devices if they are waiting to be serviced. -A device 
that is waiting to be serviced will respond to the poll by 
setting a bit in the status byte read by the PP command. 


Piggyback Connectors: Connectors that have plugs above their pins, 
allowing more than one cable to be connected at the same point. 


Remote Operation: Operation of a device using control information 
device (for example, the controller on the GPIB). 


Serial Poll: A method of polling that asks each device in turn if it 
needs servicing. This method is slower than parallel polling 
but it can be used with more devices. A serial poll is 
initiated after the SRQ line is pulled low by a device, and it 
uses the SRQ command. 


Standard: A way of doing something that has been defined by a 
standards committee. Products that adhere to a single standard 
are compatible with each other. For example, the Apple GPIB 


adheres to the IEEE-488 standard. 


Star Connected: A bus configuration in which one device is like 
the hub of a wheel with the other devices on the rim of the 
wheel, connected to the first device along the spokes. This 
configuration is not recommended. 


Talker: A device that is enabled to transmit data over a bus. The 
IEEE~488 standard permits only one talker at a time. 


Term: Short for terminator. 

Terminator: A particular symbol or character that is used to mark 
the end of something (for example, a string of data). <CR>, 
<EOS> and EOI are all used as GPIB terminators. 


TMS 9914 - The GPIB adaptor chip around which the Apple GPIB is 
designed. It is made by Texas Instruments. 


Trigger: To cause something to happen immediately. Triggers are 
used for synchronization or enabling events. 
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INDEX 


A CA command 22, 32, 45, 69 
cables 
Apple IEEE interconnection 4 
AB command 22, 37, 46, 69 IEEE standard 12-16 


ABORT: see AB command card connector 5 
acceptor handshake function 1/7 CHR$ function 24, 29, 49-42 


active low logic 14 for Integer BASIC 51 
address circuitry 72 

my listen 43 CL command 22, 33, 45 

my talk 43 clamp, metal connector 5 


addresses 24 
conventions 2 
listener 24, 39 


clear all interfaces 37 
clear device 43 
clear select device 43 


secondary 23-24, 41 CLEAR: see CL command 
talker 24, 4@ closing the Apple 7 
addressing switches 25 CLRAL: see CA command 
AHI] function 17 CMD error 38 
Apple IEEE interconnection cable cnt error 38 
4 commands 2$-37 
Apple II IEEE-488 72 data transfer 27 
Apple Language Card 4 descriptions 25 
Apple Pascal Operating System 65 protocol 26 
Apple 6592 Assembler/Editor 55, set operating characteristics 
63, 65 27 
APPLESOFT 73 | string 29-21, 27 
ASCII codes 39-42 commas, input with 54 
Assembler/Editor, Apple 6592 55, configure parallel poll 43 
63, 65 connections, GPIB 13 
asynchronous 73 connector slot 1, 4 
ATN line 13-14 connectors 
ATteNtion line 14 card 5 
IEEE 5 
piggyback 9 
B control characters parameter 29 


control codes 42 
control function 73 


Backus-Naur Form: see BNF control lines 9, 13, 14 
basic listener function 1/7 controller 9, 73 
basic talker function 1/7 controller function 18 
block diagram 9 count parameter 21-26, 39-31 
block transfers 55 CTRL 73 
BNF 29-23 current 72 
buffered input 12, 73 Cl function 18 
buffers, data 61 C2 function 18 
bus C3 function 17 

IEEE-488 _ 1 C4 function 17 

maximum length 19 C25 function 17 


transfers 27 
BUS error 38, 52 
BUS? 20, 22 te. 
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D 


daisy chained 9-11, 73 
data buffers 6l 
data lines 9-14 
data parameter 29-23 
data rates 12 
fast transfer 62 
data string 29-23, 54 
DAta Valid line 16 
DAV line 13, 16 
DC function 17 
DCL 43 
decimal digit 23 
default values 19 
don’t reset 26 
reset 26 
device clear 43 
device clear function 17 
device number 23 
device operating features 24 
device trigger function 18 
devices 
maximum number 9-19 
test 2 
DEVICE: see DV command 
direct memory access 12, 73 
disable parallel poll 37, 43 
disable serial poll 43 
disk controller card 4 
DMA 12, 73 
DOS 
commands 26 
dimension statements 53 
I/O locations 53 
DT function 18 
DV command 19, 22, 27, 29, 47, 
69 


E 


edge connector 72 

electrical requirememts 13 
enable 22-23 

enable byte 36 

enable list 23, 36 

enable parallel poll 36, 43 
enable serial poll 43 

End Or Identify: see EOI line 
EOI line 13-14, 29-31, 58-59 


EOS: see ES command 
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EOS character 23, 27, 39-31, 
58-59 

error messages 38 

ES command 22, 27-28, 47 


- 


fast transfers routines 55-63 
functions 


control 73 
IEEE 16-18 


G 


GET statement 43, 54 
go to local 43 
GPIB 1 
connections 13 
error messages 38 
listener addresses 39 
secondary addresses 41 
talker addresses 46 
ground 6 
shield 5, 13 


group execute trigger 18, 32, 43 


GTL 43 
H 
handshake 14, 73 


hex digit 23 

HP 3438A Multimeter 6/7 

HP 3586C Selective Level Meter 
67-68 

HP-IB 1 


IEEE connector 5 

IEEE Standard 488 1-2 
IEEE Standard screw 3, 6 
IEEE-488 bus 1 

IEEE-488 card 1, 72 

IFC line 13, 15 

input, buffered 73 

INPUT statement 25, 54 


input with commas 54 
installation 3-7 


instrument modes, reset 29 


Integer BASIC 73 
interface 73 
interface cards 
Apple Language 4 
disk controller 4 
I[EEE-488 1 
interface clear function 
InterFace Clear line 15 
IN#n 19, 26, 52-53 
I/O registers 55 


J 


jumper 25, 73 


L 


LA command 22, 33-34, 45 
length, bus 19 


LF command 19, 22, 27, 29-31, 


46, 67, 69 
LINEFEED: see LF command 
lines 


ATN 14 
DAV 16 
EOI 14 
IFC 15 
NDAC 15 
NRFD 15 
REN 15 
SRQ 15 


listen list 21-26, 29-34, 37 


listener 9, 23, 74 
primary 23 

listener addresses 24, 39 

LL command 22, 34, 45, 69 

LLKAL: see LL command 

LLO 43 

LO command 22, 34, 45 

local lockout 43 

local operation 74 

LOCAL: see LA command 

LOCDV: see LO command 


LST error 38 


LSTN bus sequence 43 


Ll function 17 


M 


maximums 


bus length 14 


number of dev 
current 72 


metal connector clamp 5 


metallic interi 
MLA 43 
MTA 43 
my listen addre 
my talk address 


N 


NDAC line 13, 
negative logic 


Not Data ACcepted line 


ices 


or 6 


ss 43 


43 


15 
14 


Not Ready For Data line 


NRFD line 13, 
number, device 


15 
23 


15 


number of devices, maximum 9-19 


O 


off/on 23 


ONERR GOTO statement 


ONERR routine 


52 


opening the Apple 3 


operation 


local 74 
remote 74 


output data format 


p 


parallel poll 36, 74 


configure 43 
disable 37, 
enable 36, 4 
function 17 
unconfigure 


43 
3 


37, 43 


19 


38 


INDEX 77 


Pascal 55, 65 RM command 22, 33, 45 

PD command 22, 37, 46 ROM: see read only memory 1 
PE command 22, 36, 46 

peripheral connector slot 1, 4 

piggyback connectors 9, 74 


PP command 22, 36, 46 S 
PPC 43 
PPD 43 


sample programs 6/7 


PPDIS: see PD command SC command 19, 22, 26, 27-28, 


PPE 43 47, 52-53, 55, 67, 69 
PPENB: see PE command SCREEN: see SC command 
PPOLL: see PP command 


3. 6,7 
PPU 43 saad ial 


PPUAL: see PU command 
primary listener 23 
primary talker 23 

PRINT statement 25, 27, 54 


secondary address 23-24, 41 
select device clear 43 
semicolon 27, 31 

send routine 58 


programming the GPIB 19 serial poll 35, 74 
programs, sample 6/7 disable 43 

PR#n 19, 26, 28, 29, 52-53 enable 43 

PU command 22, 46 Service ReQuest line 15 


shield ground 5, 13 
SH1 function 16 
skip reinitialize function 53 
Q slot, peripheral connector 1, 4 
source handshake function 16 
SP command 22, 35, 45 
R SPD 43 
SPE 43 
special symbols 2 


RA command 22, 33, 45, 69 specifications 72 


RC command 22, 31, 44 SPOLL: see SP command 

RD command 22, 39, 44, 53, 55, SR command 22, 35, 45, 53 
67-68 srq 23 

read only memory 1 SRQ line 13, 15, 35 

READCNT: see RC command SRQD: see SR command 


READ: see RD command 


Standard 74 
receive routine 59 


star connected 9-11, 74 


registers static discharge 3 
I/O 55 status word 23, 35-36 
9914 49 


itch ddressi 25 
REMAL: see RA command aaa a Sonar 


REMDV: see RM command 

remote enable function 17 

Remote ENable line 15 T 
remote operation 74 


REN line 13, 15, 33-34 TALK bus sequence 43 


requirements, electrical 13 talker 9, 22-24, 30-32, 35, 74 
reset card default values 19, 26 addresses 24, 4@ 
reset instruction 28 primary 23 
reset instrument modes 29 term 22-23, 30-31, 74 
RESET key 29, 34 terminator: see term 
respond to service request test device 2 
function 17 TG command 29, 22, 32, 44, 67-68 
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three-state operation 72 
three-wire handshake 15 


TMS 9914 49, 55, 57, 65, 74 
transfer control lines 15 


trigger 74 
TRIGR: see TG command 
T3 function 17 


U 


unconfigure parallel poll 37, 43 
universal unlisten command 24 


universal untalk command 24 
UNL command 24, 43 
unlisten: see UNL command 
UNT command 43 

untalk: see UNT command 
UNTALK: see UT command 

using addresses 25 

UT command 22, 37, 47 


V 


W 


wait routine 6@ 

WC command 22, 39, 44, 53 
WRITECNT: see WC command 
WRITE: see WT command 


WT command 22, 29, 44, 46-47, 


52-53, 55, 68 
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XF command 22, 32, 44 
XFER bus sequence 43 
XFER: see XF command 
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APPLE GPIB COMMAND SUMMARY 


COMMAND FORMAT BASIC BUS? ~—~PAGE 
WRITE WT <listen list> <data> <E0S> PRINT YES 29 
WRITECNT WC <listen list> <count> <data> PRINT YES 3¢ 
READ RD <talker> <CTRL-Z> <data> <term> INPUT YES 39 
READCNT RC <talker> <CTRL-Z> <count> <data> <term> INPUT YES 31 
XFER XF <talker> <CTRL-Z> <listen list> <CR> PRINT YES 32 
TRIGR TG <listen list> <CR> PRINT YES 32 
CLRAL CA <CR> PRINT YES 32 
CLEAR CL <listen list> <CR> PRINT YES 33 
REMAL RA <CR> PRINT YES 33 
REMDV RM <listen list> <CR> PRINT YES 33 
LLKAL LL <CR> PRINT YES 34 
LOCAL LA <CR> PRINT YES 34 
LOCDV LO <listen list> <CR> PRINT YES 34 
SRQD SR <srq> <CR> INPUT YES 35 
SPOLL SP <talker> <CTRL-Z> <status word> <CR> INPUT YES 35 
PPOLL PP <status word> <CR> INPUT YES 36 
PPENB PE <enable list> <CR> PRINT YES 36 
PPDIS PD <listen list> <CR> PRINT YES 37 
PPUAL PU <CR> PRINT YES 37 
ABORT AB <CR> PRINT YES 37 
LINEFEED LF <off/on> <CR> PRINT NO 27 
EOS ES <E0S> <CR> PRINT NO 28 
SCREEN SC <off/on> <CR> PRINT NO 28 
DEVICE DV <device number> PRINT NO 29 
UNTALK UT <CR> PRINT YES 37 
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APPLE GPIB COMMAND STRINGS 


<listen list> ::= <CTRL-Z> | <listener> <CTRL-Z> | <listener> <listen list> 
<listener> ::= <primary listener> | <primary listener> <secondary address> 
<primary listener> ::= <SP> |! |" | #... > 4? 

<secondary address> ::= °’ | a | bc e- } [| ~ 


<count> ::= <decimal digit> <CTRL-Z> | <decimal digit> <count> 
NOTE: The maximum total value for count is 255. 


<EOS> ::= any ASCII character 

<data> ::= empty | any ASCII character | any ASCII character <data> 
<talker> ::= empty | <primary talker> | <primary talker> <secondary address> 
<primary talker> ::= @|AJ|BI{C oe * | _ 

<hex digit> ::= O| 1 [2.4669 |A|B...F 

<decimal digit> ::= Oj|]1j|2... 9 

<status word> ::= <hex digit> <hex digit> 

<srq> ::= ASCII "T" | ASCII "F" 


<term> ::= empty | <CR> | <EOS> | EOT 
NOTE: empty if last char = <CR> or <CRD<LF> 


<device number> ::= <decimal digit> <decimal digit> 
NOTE: Maximum device number is 30 


<off/on> ::=2 ASCII "O" | ASCII "1" 
<enable list> ::=2 <listener> <enable> | <listener> <enable> <enable list> 
<enable> ::= @ 1A [Beer NI O 


<CR> ::= ASCII carriage return (13 decimal) 


<LF> ::= ASCII linefeed (10- decimal ) 
<SP> ::= ASCII space (32 decimal ) 
<CTRL-Z> ::= ASCII SUB (26 decimal) 
<CTRL-D> ::= ASCII ET (4 decimal) 


* NOTE: Marked elements are ASCII characters. 
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